next-upgrade

Upgrade Next.js projects by applying official migration guides and codemods.

Updated Mar 2, 2026
One-click install
npx skills add https://github.com/FerranGuardia/claude-autonomous-setup --skill next-upgrade-ferranguardia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: next-upgrade
Source: https://github.com/FerranGuardia/claude-autonomous-setup/tree/main/skills/frontend/nextjs-upgrade
Command: npx skills add https://github.com/FerranGuardia/claude-autonomous-setup --skill next-upgrade-ferranguardia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Upgrading Next.js across major versions is risky without official migration guidance. This skill automates the process by fetching official docs and applying codemods to align codebases with the target version, reducing manual effort and potential breakages.

Core Features & Use Cases

  • Detects the current Next.js version from package.json and identifies necessary upgrades.
  • Retrieves official migration guides and codemods, then applies automated transformations.
  • Updates key dependencies (next, react, react-dom) and validates build readiness after upgrades.
  • Use Case: You have a Next.js project on version 13 and need to upgrade to 14 with incremental steps and validation.

Quick Start

Run the upgrade workflow to migrate your project to the latest Next.js version following official guides.

Frequently Asked Questions about next-upgrade

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upgrade Next.js to a newer major version safely?

To upgrade Next.js safely, this skill automates the process by detecting your current version from package.json, fetching official migration guides, and applying necessary codemods to transform your codebase for the target version.

How do codemods help with Next.js migration?

Codemods automate code transformations during a Next.js migration by applying official automated updates to your codebase, reducing manual effort and aligning your project with the target version's requirements.

Can I upgrade Next.js incrementally across multiple major versions?

Yes, you can upgrade Next.js incrementally. This skill performs incremental upgrades across varying major versions, applying compatibility checks and validation steps to ensure build readiness at each stage.

What's the best way to update Next.js dependencies like react and react-dom?

The best way to update Next.js dependencies is through an automated workflow that updates key packages like next, react, and react-dom together, followed by a project build validation to ensure compatibility.

How do I validate my Next.js project after a major version upgrade?

To validate your Next.js project after an upgrade, this skill performs a build readiness check, ensuring that all updated dependencies and applied codemods result in a functional, compilable codebase.

Does this Next.js upgrade tool work with projects on version 13?

Yes, this tool works with projects on version 13 by detecting the current version from package.json and applying the necessary official migration guides and codemods to upgrade to newer versions like 14.