next-upgrade

Upgrade Next.js versions using official migration guides and codemods.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/namhoangg/agent-starter-kit --skill next-upgrade-namhoangg
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: next-upgrade
Source: https://github.com/namhoangg/agent-starter-kit/tree/main/cursor/skills/next-upgrade
Command: npx skills add https://github.com/namhoangg/agent-starter-kit --skill next-upgrade-namhoangg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Upgrading Next.js across major versions can be risky; this skill provides a guided, codemod-assisted path using official migration guides to minimize downtime and breaking changes.

Core Features & Use Cases

  • Guided upgrade workflow: detect current version, fetch official migration docs, and plan incremental upgrades.
  • Codemod automation: apply recommended codemods to automate breaking changes and API migrations.
  • Verification guidance: build and test steps to validate after upgrade and ensure app stability.
  • Use Case: teams upgrading Next.js from 12 to 14 or migrating App Router changes can leverage these steps.

Quick Start

Start the upgrade by checking the current Next.js version in package.json and following the official upgrade guides and codemods.

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 major version without breaking changes?▼

Upgrade Next.js across major versions by following official migration guides and applying recommended codemods to automate API changes. This guided workflow minimizes downtime by detecting your current version, fetching official docs, and planning incremental upgrades.

What is the best way to migrate Next.js App Router changes between versions?▼

Migrate Next.js App Router changes by applying official codemods that automate breaking API migrations. The workflow fetches official migration docs, runs the necessary codemods, updates dependencies, and validates app stability through build and dev runs.

How do codemods work for Next.js version migration?▼

Codemods automate Next.js version migration by programmatically updating your codebase to match new API standards. They handle breaking changes and API migrations, reducing manual refactoring errors while ensuring your app remains stable after the upgrade.

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

Validate your Next.js application after a major version upgrade by running build and dev test steps. This verification guidance ensures app stability by checking that the updated dependencies and codemod-applied changes function correctly in your local environment.

Can I use this guided upgrade workflow to migrate Next.js from 12 to 14?▼

Yes, you can use this guided upgrade workflow to migrate Next.js from 12 to 14. It detects your current version, fetches official migration guides, applies codemods for breaking changes, updates dependencies, and validates stability with build and dev runs.