Skip to content
Skill

Expo migrate module

Migrate an existing Apple/Swift Expo native module from the Expo Modules API 1.0 definition DSL to the 2.0 macro API (sometimes called v2) w

Install
Scripts
None
Platforms
Claude Code, Codex, Cursor
GitHub stars
4.2K
Last commit
1 day ago
License
MIT
Listing updated
today

When your agent uses it

Migrate an existing Apple/Swift Expo native module from the Expo Modules API 1.0 definition DSL to the 2.0 macro API (sometimes called v2) while preserving its JavaScript and TypeScript contract. Use when converting or incrementally adopting @ExpoModule, @JS, @Event, @SharedObject, or @Record in an existing module. Do not use for creating a new module, general Expo SDK upgrades, or Android/Kotlin migrations.

From the skill's SKILL.md. Your agent reads this description to decide when to load the skill.

What it can access

From a static check of its 5 files (66 KB) on GitHub on 17 November 2026. Nothing was run. Read the files before you install a skill: it can tell your agent to run anything its tools allow.

Install

This skill ships in the expo-experiments plugin. In Claude Code, add the marketplace and install the plugin (it may include other skills too):

/plugin marketplace add expo/skills
/plugin install expo-experiments@expo-plugins

Or copy only this skill to ~/.claude/skills/expo-migrate-module:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/expo/skills.git "$tmp" &&
mkdir -p ~/.claude/skills &&
rm -rf ~/.claude/skills/expo-migrate-module &&
cp -R "$tmp/plugins/expo-experiments/skills/expo-migrate-module" ~/.claude/skills/expo-migrate-module &&
rm -rf "$tmp"

For one project only, put the folder in .claude/skills/expo-migrate-module inside it instead.

Claude Code docs on skills

Copy the skill folder to ~/.agents/skills/expo-migrate-module to use it in every repository:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/expo/skills.git "$tmp" &&
mkdir -p ~/.agents/skills &&
rm -rf ~/.agents/skills/expo-migrate-module &&
cp -R "$tmp/plugins/expo-experiments/skills/expo-migrate-module" ~/.agents/skills/expo-migrate-module &&
rm -rf "$tmp"

For one repository only, put the folder in .agents/skills/expo-migrate-module inside it instead.

Codex docs on skills

Copy the skill folder to ~/.cursor/skills/expo-migrate-module to use it in every project:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/expo/skills.git "$tmp" &&
mkdir -p ~/.cursor/skills &&
rm -rf ~/.cursor/skills/expo-migrate-module &&
cp -R "$tmp/plugins/expo-experiments/skills/expo-migrate-module" ~/.cursor/skills/expo-migrate-module &&
rm -rf "$tmp"

For one project only, put the folder in .cursor/skills/expo-migrate-module inside it instead.

Cursor docs on skills

Run in a terminal (add --scope workspace to install it for the current workspace only):

gemini skills install https://github.com/expo/skills.git --path plugins/expo-experiments/skills/expo-migrate-module

Or copy the folder to ~/.gemini/skills/expo-migrate-module yourself.

Gemini CLI docs on skills

For GitHub Copilot in VS Code, copy the skill folder to ~/.copilot/skills/expo-migrate-module:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/expo/skills.git "$tmp" &&
mkdir -p ~/.copilot/skills &&
rm -rf ~/.copilot/skills/expo-migrate-module &&
cp -R "$tmp/plugins/expo-experiments/skills/expo-migrate-module" ~/.copilot/skills/expo-migrate-module &&
rm -rf "$tmp"

For one project only, put the folder in .github/skills/expo-migrate-module inside it instead.

VS Code docs on skills

Get the folder:

git clone --depth 1 https://github.com/expo/skills.git

Then copy skills/plugins/expo-experiments/skills/expo-migrate-module into your agent's skills folder as expo-migrate-module. Agents that support SKILL.md read one folder per skill.

The SKILL.md format

Expo migrate module FAQ

How do I install Expo migrate module in Claude Code?

Copy the skill folder from GitHub to ~/.claude/skills/expo-migrate-module to use it in all your projects, or to .claude/skills/expo-migrate-module in one project. Or install the expo-experiments plugin, which includes it: /plugin marketplace add expo/skills, then /plugin install expo-experiments@expo-plugins.

Does Expo migrate module run scripts?

No. It is instructions only, with no scripts. This comes from a static check of the files on GitHub; nothing was run. Read the files before you install it.

Which AI agents can use Expo migrate module?

Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose. Each reads skills in the SKILL.md format from its own folder; the install steps on this page list them.

More from expo/skills

  1. Evaluate Expo skills in this repo end-to-end - trigger accuracy, generated code quality, and runtime screenshots on iOS simulator and Androi

    • Open source
    • 4.2K GitHub stars
  2. Build and submit iOS and Android apps with EAS to TestFlight, the App Store, or Google Play

    • Open source
    • 4.2K GitHub stars
  3. Deploy Expo websites and Expo Router API routes to EAS Hosting - export the web bundle, run eas deploy for production and PR preview URLs, m

    • Open source
    • 4.2K GitHub stars
  4. Use for anything related to EAS Observe - adding `expo-observe` to an Expo project (AppMetricsRoot/ObserveRoot HOC, markInteractive and Obse

    • Open source
    • 4.2K GitHub stars
  5. Run and control a user's app on a remote iOS/Android simulator with Expo Simulators (also called EAS Simulator)

    • Open source
    • 4.2K GitHub stars
  6. Configure and use EAS Update for over-the-air JavaScript and asset updates with expo-updates and EAS CLI

    • Open source
    • 4.2K GitHub stars