Next.js Upgrade

Use this skill when

Use when upgrading Next.js/React versions, applying official Next codemods, reading migration guides, or fixing framework-version breakage.

Workflow

  1. Detect current next, react, and react-dom versions in package.json.
  2. Webfetch the relevant official Next.js migration and codemod docs.
  3. Plan incremental major-version steps before editing dependencies.
  4. Run codemods before manual fixes where official transforms exist.
  5. Validate with lint, typecheck, tests, and build; route deploy failures to vercel-deployment.

Skill graph

Read references/graph.md for routing. Related skills: next-best-practices, testing-infra, vercel-deployment, run-quality-gates.

References

Scripts

See scripts/README.md. Run the inspector before broad changes.

Assets

See assets/README.md for checklists and evals.