next-upgrade

Coordinate Next.js version detection, codemod transforms, and dependency updates for upgrades.

1|Updated May 21, 2026

Search Tags:#typescript #react #next.js #upgrade #app router #migration guide #codemod

One-click install

npx skills add https://github.com/1k-off/umbraco-observability-playground --skill next-upgrade-1k-off

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: next-upgrade
Source: https://github.com/1k-off/umbraco-observability-playground/tree/main/.agents/skills/next-upgrade
Command: npx skills add https://github.com/1k-off/umbraco-observability-playground --skill next-upgrade-1k-off

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Next.js upgrades often break apps due to breaking changes and deprecated APIs, making it hard to keep production projects current without weeks of manual fixes.

Core Features & Use Cases

Current-version detection: Reads your package.json to identify Next.js, React, and related versions before choosing the right migration path.
Codemod-driven migration: Uses official Next.js codemods to automatically apply common breaking-change transformations across your codebase.
Upgrade checklist validation: Updates dependencies in sync, applies version-specific manual steps from the official guides, then validates by building and running the app.

Use case: You maintain a Next.js App Router project and need to upgrade from an older major version to the latest release while minimizing regressions in server components, request/headers, and other migration-impacted APIs.

Quick Start

Ask your AI agent to run the next-upgrade Skill with your target version so it detects your current Next.js version, applies the appropriate codemods, updates dependencies, and verifies the upgrade by building and starting the dev server.

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 new major version without breaking my App Router project?▼

To upgrade Next.js safely, the Skill reads package.json, fetches official upgrade guidance, runs @next/codemod transforms for breaking changes, updates dependencies, and validates via npm run build and npm run dev.

Can I use this to migrate an older Next.js project incrementally across major versions?▼

Yes, this Skill coordinates incremental migration across major versions by applying version-specific codemods and manual steps from official guides before validating the build to minimize regressions.

How do I align React and React DOM versions when upgrading Next.js?▼

The Skill aligns dependencies by detecting current versions in package.json and updating Next.js, React, and React DOM in sync according to the official upgrading guidance.

What are the limitations of using codemods for a Next.js migration?▼

Codemods automate common breaking-change transformations, but manual review is still required afterward for migration-impacted APIs like server components and request headers before validating the app.