mcpField
U
upgrade-react-navigation

upgrade-react-navigation

github.com/react-navigationDevelopment23503 installsUpdated 18w ago
Repository

About upgrade-react-navigation

A skill for upgrading React Navigation across major versions while preserving existing navigation behavior. It directs coding agents to inspect the project, apply the relevant migration reference, and run available checks.

Key features

  1. 01Major-version migration guidance
  2. 02Version-specific reference selection
  3. 03Minimal behavior-preserving changes
  4. 04Clarification when APIs are uncertain
  5. 05Type, lint, and test verification

Use cases

  1. 01Upgrading React Navigation 6.x to 7.x
  2. 02Moving from 7.x to 8.x
  3. 03Checking an upgrade with project tests

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/react-navigation/skills --skill upgrade-react-navigation

After installing, type/upgrade-react-navigationin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

agents/
openai.yaml
references/
upgrade-6-to-7.md
upgrade-7-to-8.md

Details

From the project README

Upgrade React Navigation

Goal

Upgrade React Navigation to the next major version and handle all required breaking changes while preserving existing navigation behavior.

When to use

You are upgrading React Navigation major version (6.x -> 7.x or 7.x -> 8.x).

Adaptation policy

Treat the patterns in this skill as canonical starting points, not an exhaustive list. The absence of an exact matching example is not a blocker.

  • Map local code to the closest pattern here and adapt it; infer an equivalent when the structure differs.
  • Prefer the simplest upgrade that preserves behavior.
  • Keep changes minimal and upgrade only the affected code.

When to ask for clarification

Inspect the local code first.

If, after reading the relevant navigator and the upgrade reference, you cannot determine with high confidence whether an API changed or how to update it, pause and ask the user before editing code.

Ask for clarification when:

  • A navigator uses APIs that are not covered in the official documentation or the upgrade reference.
  • The upgrade would require assumptions about which behavior changes are acceptable.

References

Check @react-navigation/native in package.json first.

Load exactly one reference file unless explicitly comparing versions.

Verification

After upgrading:

  • Determine the package manager from package.json or the lockfile.
  • Run the existing type checker, linter, and relevant tests when scripts are available.
  • Work through the "Automated checks" and "Manual checks" in the loaded reference. If a step cannot run, report why.

Comments

Markdown supported