migrate-to-static-config — Claude Code skill
migrate-to-static-config converts React Navigation from JSX Navigator and Screen elements to object-based static configuration. Useful when adopting Static API in versions 7.x and 8.x.
no license 302 installs ★ 23 updated 2026-06-26
npx skills add react-navigation/skills --skill migrate-to-static-config -a claude-codeWhat migrate-to-static-config does
The skill transforms dynamic React Navigation setup into static objects while keeping behavior, TypeScript types, and deep links intact. Handles nested navigators, groups, render callbacks, getComponent screens, and custom navigators.
Before running, it reads the @react-navigation/native version from package.json and loads the matching reference guide for 7.x or 8.x. When a straightforward static conversion cannot preserve behavior, the skill offers .with() for navigator wrappers or context for passing extra screen data. Static API is unavailable in versions prior to 7.x.
After code changes, it runs the project's type checker, linter, and tests if configured. When verification is not available, it performs a manual review against the reference checklist.
What it helps with
- convert React Navigation from JSX to static objects
- preserve types and deep links when changing navigator API
- migrate nested navigators and screen groups
- adapt render callbacks and
getComponentfor Static API
Example prompts for the agent
- Convert this navigator to Static API
- Migrate all screens in
App.tsxto React Navigation static config - Turn
NavigatorandScreeninto an object, keep the behavior
How to install migrate-to-static-config
1Skills CLI (Vercel)
npx skills add react-navigation/skills --skill migrate-to-static-config -a claude-code2Manually: put the files in place
~/.claude/skills/migrate-to-static-config/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/migrate-to-static-config/
1Skills CLI (Vercel)
npx skills add react-navigation/skills --skill migrate-to-static-config -a codex2Manually: put the files in place
.agents/skills/migrate-to-static-config/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add react-navigation/skills --skill migrate-to-static-config -a cursor2Manually: put the files in place
.cursor/skills/migrate-to-static-config/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install react-navigation/skills skills/migrate-to-static-config2Manually: put the files in place
.github/skills/migrate-to-static-config/SKILL.md1Skills CLI (Vercel)
npx skills add react-navigation/skills --skill migrate-to-static-config -a gemini-cli2Platform CLI
gemini skills install https://github.com/react-navigation/skills --path skills/migrate-to-static-configManually: put the files in place
.devin/skills/migrate-to-static-config/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add react-navigation/skills --skill migrate-to-static-config -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about migrate-to-static-config
How to install migrate-to-static-config in Claude Code?
Run npx skills add react-navigation/skills --skill migrate-to-static-config -a claude-code, the skill appears in ~/.claude/skills/migrate-to-static-config/SKILL.md.
What does migrate-to-static-config do?
Converts React Navigation navigators from JSX to Static API objects, preserving screens, types, deep links, and nested structures. Works with versions 7.x and 8.x.
Which React Navigation versions does the skill support?
Versions 7.x and 8.x. The skill checks the version in package.json and loads the appropriate reference; Static API is not supported in versions before 7.x.