<p align="center">
<a href="https://docs.expo.dev/skills/" target="_blank">
<img src="https://raw.githubusercontent.com/expo/skills/HEAD/assets/expo-skills.png" alt="Expo Skills" width="100%" />
</a>
</p>
<h3 align="center">Expo Skills</h3>
<p align="center">
<a href="https://skills.sh/expo/skills"><img src="https://skills.sh/b/expo/skills" alt="skills.sh installs" /></a>
<img src="https://img.shields.io/badge/Expo-official-000020" alt="Official Expo" />
<img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT license" />
</p>
<p align="center">
Expo 앱을 빌드하고, 배포하고, 업그레이드하고, 디버깅하기 위한 Expo 팀의 공식 AI 에이전트 스킬입니다.
</p>
작동 방식 (How It Works)
스킬은 AI 에이전트에게 집중된 Expo 지식을 제공합니다. 언제 Expo API를 사용해야 하는지, 일반적인 워크플로우는 어떻게 구성해야 하는지, 그리고 어떤 Expo, EAS, React Native, iOS, Android 제약 조건이 중요한지를 알려줍니다. Expo 문서(documentation), Expo CLI, 그리고 EAS CLI가 여전히 진실의 원천(source of truth)이며, 이 스킬들은 에이전트가 이를 올바르게 적용하도록 돕습니다.
설치 (Installation)
Claude Code 또는 Codex의 경우, 업데이트가 공식 플러그인 마켓플레이스에서 처리되도록 플러그인을 설치해야 합니다. Cursor, OpenCode 및 기타 AI 코딩 에이전트의 경우, skills CLI를 사용하세요.
| 경로 (Path) | 적합한 경우 (Best for) |
|---|
| Plugin install | Claude Code 또는 Codex이며, 업데이트가 해당 공식 플러그인 마켓플레이스에서 처리되는 경우. |
| Skills CLI | Cursor, OpenCode, GitHub Copilot, Windsurf, Gemini, Cline, AMP, Factory Droid, Antigravity, Kiro CLI 및 기타 AI 코딩 에이전트. |
Skills CLI
skills CLI를 사용하여 모든 Expo 스킬을 설치하세요:
npx skills@latest add expo/skills --skill '*'
이는 모든 에이전트를 선택하지 않으면서 모든 Expo 스킬을 선택합니다. CLI는 여전히 어디에 설치할지 물어볼 것이며, 특정 에이전트를 직접 지정하려면 --agent <agent>를 추가하세요.
대부분의 에이전트의 경우, 이것이 필요한 유일한 설치 명령어입니다. 프로젝트 루트에서 실행한 다음, 에이전트 세션을 다시 시작하거나 새로 고침하여 설치된 SKILL.md 파일을 검색할 수 있도록 하세요.
Claude Code Plugin
공식 Claude Code 플러그인 마켓플레이스에서 설치:
claude plugin install expo@claude-plugins-official
Claude Code 내부에서는 /plugin install expo@claude-plugins-official를 실행할 수도 있습니다.
Codex 플러그인
OpenAI가 큐레이션한 Codex 마켓플레이스에서 설치:
codex plugin add expo@openai-curated
Codex 내부에서는 /plugins를 열고 OpenAI가 큐레이션한 마켓플레이스에서 expo를 설치할 수도 있습니다.
업데이트하기
Claude Code와 Codex 플러그인 설치는 각자의 공식 플러그인 마켓플레이스를 통해 업데이트됩니다.
skills CLI 설치의 경우, 다음 명령어로 설치된 스킬을 업데이트합니다:
단일 Expo 스킬을 업데이트하려면 이름을 전달합니다:
npx skills@latest update expo-router
사용해 보기
설치 후, 에이전트에게 다음과 같은 Expo 관련 질문을 할 수 있습니다.
- "탭(tabs), 모달 및 애니메이션을 갖춘 네이티브 느낌의 Expo Router 화면 구축."
- "풀 리퀘스트에서 미리보기를 빌드하는 EAS 워크플로우 생성."
- "최신 Expo SDK로 이 앱 업그레이드를 도와줘."
- "이 EAS 업데이트 롤아웃 상태가 양호한지 확인해 줘."
에이전트는 작업 컨텍스트와 각 스킬의 설명을 기반으로 적절한 스킬을 선택합니다.
포함된 스킬
스킬은 무료와 유료의 경계를 명확히 하기 위해 두 그룹으로 나뉩니다. 각 스킬 설명에는 동일한 레이블이 붙어 있으며, 모든 서비스 스킬은 비용/플랜 제한에 대한 안내로 시작합니다.
여기서 시작하기
모든 Expo/EAS 작업에 대해 이것을 먼저 로드한 다음, 아래의 특정 스킬로 라우팅하세요.
| 스킬 | 용도 |
|---|
expo-overview | 라우터 및 공유 설정 규칙; 요청이 모호하거나 사용자가 특정 Expo 도구를 명시하지 않았을 때 진입점. |
프레임워크 (오픈 소스)
무료 오픈 소스 Expo SDK 및 React Native 스킬입니다.
| 스킬 | 용도 |
|---|
expo-project-structure | 새로운 Expo 앱의 폴더 구조: src/ 레이아웃, 라우트 전용 app/, 화면(screens), 서버 코드, 플랫폼별 파일. |
| ... | |
서비스 및 유료 배포
핵심 목적이 유료 Expo Application Services (EAS)를 사용하는 스킬입니다.
| Skill | Use it for |
|---|
eas-app-stores | iOS/Android 앱 빌드 및 제출: Expo 및 기타 React Native 프로젝트, 그리고 기존 네이티브 앱을 포함합니다. TestFlight, 프로필, 버전 관리 및 메타데이터 작업을 수행할 수 있습니다. |
| ... | |
실험적 기능 (Experimental)
아직 최종 확정되지 않은 Expo API용 스킬입니다. 내용은 변경되거나 폐지될 수 있으며, 기반이 되는 API가 안정화되면 상위 그룹으로 승격됩니다. 이들은 별도의 expo-experiments 플러그인(설치 시 expo와 함께 설치) 또는 skills CLI를 통해 개별적으로 배포됩니다.
| Skill | Use it for |
|---|
expo-migrate-module | Swift Expo 모듈을 Modules API 1.0 정의 DSL에서 2.0 매크로 API로 마이그레이션합니다. |
Expo MCP 서버
스킬은 에이전트에게 Expo 작업이 어떻게 수행되는지 가르칩니다. Expo MCP 서버는 이 작업을 실제로 수행할 수 있는 실시간 접근 권한을 제공합니다: 요청 시 최신 Expo 문서를 읽고, npx expo install을 사용하여 호환 가능한 의존성을 설치하며, EAS 빌드 및 워크플로우를 트리거하고 모니터링하고, TestFlight에서 충돌 데이터를 가져오며, 시뮬레이터에서 실행 중인 앱의 스크린샷을 찍습니다.
expo 플러그인은 이 MCP 구성을 묶어 제공하므로, Claude Code 및 Codex 플러그인을 설치하면 자동으로 연결됩니다. 다른 에이전트나 개별적으로 추가하려면 Expo MCP 설정 가이드를 따르십시오.
자주 묻는 질문 (FAQ)
어떤 AI 코딩 에이전트가 지원되나요?
Cursor, OpenCode, GitHub Copilot, Windsurf, Gemini, Cline, AMP, Factory Droid, Antigravity, Kiro CLI 및 유사한 AI 코딩 도구의 경우 npx skills@latest add expo/skills --skill '*'를 사용하십시오.
스킬을 설치해야 하나요, 아니면 플러그인을 설치해야 하나요?
Claude Code 또는 Codex를 사용하는 경우에는 플러그인을 사용하십시오. 이는 플러그인 마켓플레이스를 통해 업데이트됩니다. Cursor, OpenCode 및 기타 AI 코딩 에이전트의 경우 npx skills@latest add expo/skills --skill '*'를 사용하십시오.
신뢰할 수 있는 출처(source of truth)는 무엇인가요?
Expo 문서, Expo CLI, 그리고 EAS CLI가 신뢰할 수 있는 출처입니다. 이 스킬들은 에이전트에게 실제 프로젝트에서 Expo 가이드를 적용하는 방법을 가르칩니다.
피드백
모든 스킬에는 특정하고 실행 가능한 피드백을 제출하는 방법으로 npx --yes @expo/agent-cli@latest feedback 지침이 포함되어 있습니다.
라이선스 (License)
MIT
