next-upgrade

Upgrade Next.js projects to the latest major version using official migration guides and codemods.

Updated Apr 5, 2026
One-click install
npx skills add https://github.com/NarakCODE/rakui --skill next-upgrade-narakcode
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: next-upgrade
Source: https://github.com/NarakCODE/rakui/tree/main/.agents/skills/next-upgrade
Command: npx skills add https://github.com/NarakCODE/rakui --skill next-upgrade-narakcode

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Upgrading Next.js can be risky due to breaking changes, deprecated APIs, and version-specific configuration differences. This Skill guides you through detecting the current version, applying official migration steps, and updating related dependencies to minimize downtime.

Core Features & Use Cases

  • Detects current Next.js and related React dependencies from package.json.
  • Applies official codemods and incremental upgrades for major version jumps.
  • Provides migration guidance and validation steps to ensure a smooth upgrade in real-world projects.

Quick Start

Upgrade Next.js to the latest major version using official migration 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 the latest major version safely?

To upgrade Next.js safely, detect your current version from package.json, apply official codemods, update React and related dependencies, and validate the build against migration notes to handle breaking changes.

What are Next.js codemods and how do they help with migration?

Next.js codemods are automated code transformation tools that apply official migration steps to handle deprecated APIs and version-specific configuration changes during a major version upgrade, minimizing downtime and manual errors.

Do I need to upgrade React and React DOM when migrating Next.js?

Yes, upgrading Next.js requires evaluating and updating React, React DOM, and related dependencies to determine applicable migration steps and ensure compatibility with the new Next.js major version.

What's the best way to handle breaking changes when upgrading Next.js?

The best way to handle breaking changes is by following official migration guides, applying official codemods for incremental upgrades, and validating your project build against the specific migration notes for the target version.

Can I upgrade Next.js across multiple major version jumps at once?

Upgrading Next.js across major version jumps requires detecting current versions from package.json and applying incremental official codemods and migration steps to safely bridge deprecated APIs and configuration differences.

Why does my Next.js build fail after updating to a new major version?

A failed Next.js build after an upgrade usually stems from unhandled breaking changes or deprecated APIs; validate your build against official migration notes and ensure all related React dependencies are updated.