skills README

The project's README from github.com/expo/skills. As one markdown file: README.md.

Expo Skills

Expo Skills

skills.sh installs Official Expo MIT license

Official AI agent skills from the Expo team for building, deploying, upgrading, and debugging Expo apps.

How It Works

Skills give AI agents focused Expo knowledge: when to use Expo APIs, how to structure common workflows, and which Expo, EAS, React Native, iOS, and Android constraints matter. Expo documentation, Expo CLI, and EAS CLI remain the source of truth; these skills help agents apply them correctly.

Installation

For Claude Code or Codex, install the plugin so updates are handled by the official plugin marketplace. For Cursor, OpenCode, and other AI coding agents, use the skills CLI.

Path Best for
Plugin install Claude Code or Codex, with updates handled by their official plugin marketplaces.
Skills CLI Cursor, OpenCode, GitHub Copilot, Windsurf, Gemini, Cline, AMP, Factory Droid, Antigravity, Kiro CLI, and other AI coding agents.

Skills CLI

Install all Expo skills with the skills CLI:

npx skills@latest add expo/skills --skill '*'

This selects every Expo skill without selecting every agent. The CLI will still ask where to install them; to target one agent directly, add --agent <agent>.

For most agents, this is the only install command you need. Run it from the project root, then restart or refresh your agent session so it can discover the installed SKILL.md files.

Claude Code Plugin

Install from the official Claude Code plugin marketplace:

claude plugin install expo@claude-plugins-official

You can also run /plugin install expo@claude-plugins-official inside Claude Code.

Codex Plugin

Install from the OpenAI-curated Codex marketplace:

codex plugin add expo@openai-curated

You can also open /plugins in Codex and install expo from the OpenAI-curated marketplace.

Updating

Claude Code and Codex plugin installs are updated through their official plugin marketplaces.

For skills CLI installs, update installed skills with:

npx skills@latest update

To update a single Expo skill, pass its name:

npx skills@latest update expo-router

Try It

After installing, ask your agent Expo-specific questions like:

Agents choose the right skill from the task context and each skill's description.

Skills Included

Skills come in two groups so the free vs paid boundary is clear. Each skill's description carries the same label, and every services skill opens with a costs/plan-limits note.

Start Here

Load this first for any Expo/EAS task, then route to the specific skill below.

Skill Use it for
expo-overview Router and shared setup rules; the entry point when a request is vague or the user hasn't named a specific Expo tool.

Framework (open source)

Free, open-source Expo SDK and React Native skills.

Skill Use it for
expo-project-structure Folder structure for a new Expo app: src/ layout, routes-only app/, screens, server code, platform-specific files.
expo-router Expo Router navigation: file-based routes, links, native stacks, modals, sheets, native tabs, and headers.
expo-animation Polished React Native animations and gestures with Reanimated, Gesture Handler, Expo Router, and expo-haptics.
expo-native-ui Native-feeling screen styling, semantic colors, controls, icons, media, and visual effects.
expo-design-system In-app design systems: a token theme (color, spacing, typography, radius, shadow, motion), reusable component conventions, and design-system drift audits.
expo-ui @expo/ui native components: universal cross-platform first, with SwiftUI and Jetpack Compose for platform-specific needs.
expo-data-fetching API calls, React Query, SWR, caching, offline support, and Expo Router data loaders.
expo-dom Expo DOM components for gradually using web code in native apps.
expo-web-to-native Migrating an existing web/React app (Next.js, Vite, CRA) to a native iOS/Android app with Expo.
expo-module Expo native modules and views with Swift, Kotlin, TypeScript, config plugins, and autolinking.
expo-brownfield Adding Expo or React Native to an existing iOS or Android app.
expo-dev-client Development clients (local builds are free; EAS Build/TestFlight is a paid step).
expo-examples The expo/examples repo of with-* integrations to adapt or scaffold a new project from.
expo-app-clip iOS App Clip targets, AASA files, associated domains, and Smart App Banners.
expo-upgrade Expo SDK upgrades, dependency conflicts, deprecated packages, and cache cleanup.
expo-skill-feedback Share what worked or fell short across Expo, its skills, docs, CLIs, or MCP, and control opt-in usage telemetry.

Services & paid distribution

Skills whose core purpose uses paid Expo Application Services (EAS).

Skill Use it for
eas-app-stores Build and submit iOS/Android apps: Expo and other React Native projects, plus existing native apps; TestFlight, profiles, versioning, and metadata.
eas-hosting Deploying Expo websites and Expo Router API routes to EAS Hosting: secrets, custom domains, Cloudflare Workers.
eas-workflows EAS Workflow YAML files and CI/CD automation.
eas-observe EAS Observe setup and launch, route, event, and version metrics.
eas-update EAS Update setup, OTA publishing, runtime compatibility, testing, and debugging.
eas-update-insights EAS Update health, crash rates, launch counts, payload size, and rollout gates.
eas-simulator Run and drive your app on a remote iOS simulator or Android emulator on EAS cloud - from the CLI or an agent, with a live browser preview (iOS only).

Experimental

Skills for Expo APIs that are not finalized. Content may change or be retired; skills graduate to the groups above when the underlying API stabilizes. These ship in the separate expo-experiments plugin (install it alongside expo), or individually via the skills CLI.

Skill Use it for
expo-migrate-module Migrating a Swift Expo module from the Modules API 1.0 definition DSL to the 2.0 macro API.

Expo MCP Server

Skills teach an agent how Expo work gets done. The Expo MCP server gives it live access to actually do that work: read the latest Expo docs on demand, install compatible dependencies with npx expo install, trigger and monitor EAS builds and workflows, pull crash data from TestFlight, and screenshot a running app in the simulator.

The expo plugin bundles this MCP configuration, so Claude Code and Codex plugin installs wire it up automatically. For other agents, or to add it on its own, follow the Expo MCP setup guide.

FAQ

Which AI coding agents are supported?

Use npx skills@latest add expo/skills --skill '*' for Cursor, OpenCode, GitHub Copilot, Windsurf, Gemini, Cline, AMP, Factory Droid, Antigravity, Kiro CLI, and similar AI coding tools.

Should I install the skills or the plugin?

Use the plugin for Claude Code or Codex; it stays updated through the plugin marketplace. Use npx skills@latest add expo/skills --skill '*' for Cursor, OpenCode, and other AI coding agents.

What is the source of truth?

Expo documentation, Expo CLI, and EAS CLI are the source of truth. These skills teach agents how to apply Expo guidance in real projects.

Usage telemetry & feedback

Automatic usage telemetry is off by default. When enabled (Claude Code only), it sends anonymous usage events: the skill name, platform, and a hash of a random local install id. Never code, prompts, file paths, or personal data.

Submission details and telemetry controls live in expo-skill-feedback.

License

MIT

skills (expo/skills)

Searching Database…

2.9K ·GitHub
Skills
What is this?A collection of AI agent skills that teach coding agents how to build, deploy, upgrade, and debug Expo and EAS projects correctly.
Is this an app, or a set of instructions for my coding agent?It is a set of SKILL.md files (skills) that get installed into an AI coding agent, not a standalone app; Expo docs, Expo CLI, and EAS CLI remain the actual source of truth.
How do I install these skills into my agent?For Claude Code or Codex, install the official plugin (e.g. /plugin install expo@claude-plugins-official); for Cursor, OpenCode and other agents, run the skills CLI command to add all Expo skills.
Which coding agents are supported?Claude Code and Codex via their official plugin marketplaces, plus Cursor, OpenCode, GitHub Copilot, Windsurf, Gemini, Cline, AMP, Factory Droid, Antigravity, and Kiro CLI via the skills CLI.
Are all the skills free to use?No - framework/SDK skills are free and open source, but 'Services & paid distribution' skills (EAS Build, Hosting, Workflows, Update, Observe) rely on paid Expo Application Services, and each opens with a costs/plan-limits note.
Does this work on any OS?Yes, the skills CLI is run via npx so it works cross-platform; installed skills then apply to Expo apps targeting iOS and Android.
Does installing this send any data about my code?Automatic usage telemetry is off by default; when enabled (Claude Code only) it only sends the skill name, platform, and a hash of a random install id - never code, prompts, file paths, or personal data.
What does the Expo MCP server add on top of the skills?It gives the agent live access to actually do the work the skills describe: reading current Expo docs, installing compatible dependencies, triggering and monitoring EAS builds/workflows, pulling TestFlight crash data, and screenshotting a running simulator app.
Where should an agent start if a request is vague?Load the expo-overview skill first; it covers router and shared setup rules and routes the agent to the specific skill needed for the task.
Can I try experimental, not-yet-stable Expo API skills?Yes, via the separate expo-experiments plugin (installed alongside expo) or individually through the skills CLI; these cover APIs like the Modules 2.0 macro migration and may change or be retired.
How do I update the skills after installing?Claude Code and Codex plugin installs update automatically through their plugin marketplaces; skills CLI installs are updated by re-running the CLI's update command, optionally naming a single skill to update.
What are similar projects?appllama-skills, jev-browser-use, open-steps, mobilecode, skills, skills, Baize, lottie
Which topics is it in?ai-coding-agent, codex-skill, react-native, claude-skills, model-context-protocol, cli-tool, skill, shell, skills, mcp-server, coding-agent, plugin
Creator
expo
Size
4.3 MB
Stars
2.9K
Updated
CommitOct 16
Age
10mo
Commits · 90 Days