Expo 官方发布 expo/skills：面向 AI Coding Agent 的开发与部署技能库

来自 Expo 团队的官方 AI 智能体技能（AI agent skills），用于构建、部署、升级和调试 Expo 应用。

Skills（技能）为 AI 智能体赋予针对性的 Expo 专项知识：何时使用 Expo API、如何组织通用工作流，以及哪些 Expo、EAS、React Native、iOS 和 Android 约束至关重要。Expo 官方文档、Expo CLI 和 EAS CLI 依然是事实来源（source of truth）；这些技能旨在辅助智能体正确应用它们。

针对 Claude Code 或 Codex，请安装插件，更新将由其官方插件市场统一处理。对于 Cursor、OpenCode 及其他 AI 编程智能体，请使用 skills CLI。

路径	适用场景
插件安装	Claude Code 或 Codex，由其官方插件市场负责更新。
Skills CLI	Cursor、OpenCode、GitHub Copilot、Windsurf、Gemini、Cline、AMP、Factory Droid、Antigravity、Kiro CLI 及其他 AI 编程智能体。

使用 skills CLI 安装所有 Expo 技能：

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

该命令会选中每一个 Expo 技能，而不会选中所有智能体。CLI 仍会询问安装到何处；若要直接指定某一个智能体，请添加 --agent <agent>。

对于大多数智能体，这是你唯一需要的安装命令。在项目根目录下运行它，然后重启或刷新智能体工作会话，使其能够发现已安装的 SKILL.md 文件。

从 Claude Code 官方插件市场安装：

bash claude plugin install expo@claude-plugins-official

你也可以在 Claude Code 内运行 /plugin install expo@claude-plugins-official。

从 OpenAI 精选的 Codex 市场安装：

bash codex plugin add expo@openai-curated

你也可以在 Codex 中打开 /plugins 并从 OpenAI 精选市场安装 expo。

Claude Code 和 Codex 插件安装通过其官方插件市场进行更新。

对于通过 skills CLI 进行的安装，请使用以下命令更新已安装的技能：

若要更新单个 Expo 技能，请指定其名称：

bash npx skills@latest update expo-router

安装完成后，即可向你的智能体询问特定于 Expo 的问题，例如：

• “使用标签页（tabs）、模态框（modals）和动画构建一个原生质感的 Expo Router 屏幕。”
• “创建一个在拉取请求（pull requests）时构建预览版本的 EAS 工作流。”
• “帮我把这个应用升级到最新的 Expo SDK。”
• “检查这次 EAS Update 推送是否健康。”

智能体会根据任务上下文和每个技能的描述选择正确的技能。

技能分为两组，以便清晰界定免费与付费界限。每个技能的描述都带有相同的标签，且每个服务类技能开头都注明了成本/方案配额说明。

处理任何 Expo/EAS 任务时请首先加载此项，随后再路由至下方的具体技能。

技能	适用场景
expo-overview	路由与共享配置规则；当请求较为模糊或用户未明确指定特定 Expo 工具时的入口起点。

免费、开源的 Expo SDK 和 React Native 技能。

技能	适用场景
expo-project-structure	全新 Expo 应用的目录结构：src/ 布局、仅含路由的 app/、屏幕界面、服务端代码、平台特定文件。
expo-router	Expo Router 导航：基于文件的路由、链接、原生堆栈（native stacks）、模态框、底抽屉（sheets）、原生标签页和标题栏。
expo-animation	结合 Reanimated、Gesture Handler、Expo Router 和 expo-haptics 打造细腻的 React Native 动画与手势。
expo-native-ui	原生质感的屏幕样式、语义化颜色、控件、图标、媒体和视觉效果。
expo-design-system	应用内设计系统：Token 主题（颜色、间距、排版、圆角、阴影、动态效果）、可复用组件规范以及设计系统偏离审计。
expo-ui	@expo/ui 原生组件：跨平台通用优先，结合 SwiftUI 和 Jetpack Compose 满足特定平台需求。
expo-data-fetching	API 请求、React Query、SWR、缓存、离线支持和 Expo Router 数据加载器（data loaders）。
expo-dom	用于在原生应用中逐步引入 Web 代码的 Expo DOM 组件。
expo-web-to-native	将现有 Web/React 应用（Next.js、Vite、CRA）迁移为使用 Expo 的原生 iOS/Android 应用。
expo-module	使用 Swift、Kotlin、TypeScript、配置插件（config plugins）和自动链接（autolinking）构建的 Expo 原生模块和原生视图。
expo-brownfield	向现有 iOS 或 Android 原生应用中引入 Expo 或 React Native（混合开发）。
expo-dev-client	开发客户端（本地构建完全免费；EAS Build/TestFlight 属于付费环节）。
expo-examples	汇集了各类 with-* 集成的 expo/examples 仓库，用于参考或搭建新项目脚手架。
expo-app-clip	iOS App Clip 目标、AASA 文件、关联域名（associated domains）和智能应用横幅（Smart App Banners）。
expo-upgrade	Expo SDK 升级、依赖冲突解决、弃用包替换及缓存清理。

服务与付费分发

核心用途依赖于付费 Expo Application Services (EAS) 的技能。

技能	适用场景
eas-app-stores	构建并提交 iOS/Android 应用：适用于 Expo 和其他 React Native 项目，以及现有原生应用；涵盖 TestFlight、证书描述文件（profiles）、版本管理和元数据。
eas-hosting	将 Expo 网站与 Expo Router API 路由部署至 EAS Hosting：机密（secrets）管理、自定义域名、Cloudflare Workers。
eas-workflows	EAS Workflow YAML 配置文件和 CI/CD 自动化。
eas-observe	EAS Observe 的配置与启动、路由、事件及版本指标监控。
eas-update	EAS Update 设置、OTA 热更新发布、运行时兼容性、测试与调试。
eas-update-insights	EAS Update 健康状况、崩溃率、启动次数、安装包载荷体积及灰度发布门槛（rollout gates）。
eas-simulator	在 EAS 云端远程 iOS 模拟器或 Android 仿真器上运行并操控你的应用——可通过 CLI 或智能体驱动，支持实时浏览器预览（仅限 iOS）。

针对尚未定型的 Expo API 的技能。内容可能会调整或被废弃；当下层 API 趋于稳定后，这些技能将正式晋级至上述分组中。它们随单独的 expo-experiments 插件一同分发（可与 expo 一并安装），也可以通过 skills CLI 单独安装。

技能	适用场景
expo-migrate-module	将 Swift Expo 模块从 Modules API 1.0 定义 DSL 迁移至 2.0 宏（macro）API。

技能指导智能体了解 Expo 工作的运作方式。而 Expo MCP 服务器 则为其提供实时执行这些操作的实际权限：按需读取最新 Expo 文档、使用 npx expo install 安装兼容依赖、触发并监控 EAS 构建与工作流、从 TestFlight 拉取崩溃数据，以及截取正在运行的模拟器应用屏幕截图。

expo 插件内置了该 MCP 配置，因此通过 Claude Code 和 Codex 安装插件时会自动完成配置关联。对于其他智能体，或希望单独添加该功能，请参考 Expo MCP 设置指南。

支持哪些 AI 编程智能体？

对于 Cursor、OpenCode、GitHub Copilot、Windsurf、Gemini、Cline、AMP、Factory Droid、Antigravity、Kiro CLI 及类似的 AI 编程工具，请使用 npx skills@latest add expo/skills --skill '*'。

我应该安装技能（skills）还是插件（plugin）？

对于 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 提交具体、可操作反馈的操作指引。

MIT

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

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.

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.

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.

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.

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.

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

For skills CLI installs, update installed skills with:

To update a single Expo skill, pass its name:

npx skills@latest update expo-router

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

• "Build a native-feeling Expo Router screen with tabs, modals, and animations."
• "Create an EAS workflow that builds previews on pull requests."
• "Help me upgrade this app to the latest Expo SDK."
• "Check whether this EAS Update rollout is healthy."

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

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.

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.

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.

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).

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.

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.

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.

Every skill includes instructions to submit specific, actionable feedback with npx --yes @expo/agent-cli@latest feedback.

MIT