next-upgrade

Plan and apply incremental Next.js major version upgrades using official guides and codemods.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Upgrade Next.js projects to the latest major version while minimizing breaking changes by following official migration guides and codemods.

Core Features & Use Cases

  • Guided upgrade path with links to official codemods and version guides
  • Incremental upgrade planning across major versions (e.g., 13 → 14 → 15)
  • Validation steps including build and dev runs to verify functionality

Quick Start

Identify your current Next.js version from package.json and follow the official migration guides and codemods to perform an incremental upgrade.

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

To upgrade Next.js safely, identify your current version in package.json and follow official migration guides to apply codemods and update dependencies incrementally across major versions. This minimizes breaking changes by validating the build and dev workflows after each step.

What is the best way to plan an incremental Next.js migration across multiple major versions?

The best way to plan a Next.js migration is to determine an incremental upgrade path through major versions. By fetching official Next.js upgrade guides and codemods, you can update dependencies step-by-step from one major version to the next while validating compatibility.

How do codemods help with Next.js version upgrades?

Codemods automate code transformations during a Next.js upgrade to fix breaking changes. They are fetched from official upgrade guides and applied to your project to ensure compatibility before you update dependencies and validate the build and dev workflows.

Can I upgrade Next.js directly from version 13 to 15?

You can upgrade Next.js from 13 to 15, but planning an incremental upgrade path through intermediate major versions like 14 is safer. This approach applies official codemods and validates the build at each step to minimize breaking changes.

Why is my Next.js build failing after a major version upgrade?

A Next.js build may fail after an upgrade due to breaking changes from unresolved dependency updates or missing codemods. To fix this, follow the official migration guides to apply necessary codemods, update key dependencies, and validate the dev and build workflows.

Do I need to update dependencies when upgrading Next.js?

Yes, you need to update key dependencies identified in package.json when upgrading Next.js. Applying official codemods and updating dependencies together ensures compatibility and validates the build and dev workflows during the major version migration.