skills.rest
marcosmlslira
marcosmlsliraCOMMUNITY
Explore all skills by this author →
GitHub

next-upgrade

Upgrade Next.js projects incrementally with official codemods and dependency updates.

Updated Jan 6, 2026
Search Tags:#versioning#react#migration#codemods#build#next.js#upgrade
One-click install
npx skills add https://github.com/marcosmlslira/observadordedominios --skill next-upgrade-marcosmlslira
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: next-upgrade
Source: https://github.com/marcosmlslira/observadordedominios/tree/main/.agents/skills/next-upgrade
Command: npx skills add https://github.com/marcosmlslira/observadordedominios --skill next-upgrade-marcosmlslira

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Upgrading Next.js across major versions can introduce breaking changes, deprecated APIs, and configuration mismatches that slow development and risk outages.

Core Features & Use Cases

  • Guided upgrade path: determine the correct sequence of version jumps (e.g., 13 → 14 → 15) and apply official codemods to migrate APIs.
  • Dependency synchronization: update next, react, and react-dom together to compatible versions.
  • Validation & testing: verify build and runtime steps to catch breaking changes early.

Quick Start

Run the upgrade workflow on your Next.js project to automatically detect the current version, apply codemods incrementally, update dependencies, and verify the build.

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 version across multiple major releases?▼

To upgrade Next.js across major releases safely, you migrate incrementally by determining the correct sequence of version jumps. This approach applies official codemods and updates dependencies step-by-step to handle breaking changes.

What is the best way to handle breaking changes during a Next.js migration?▼

Handling breaking changes during a Next.js migration is best done by applying official codemods. These scripts automatically migrate deprecated APIs and configuration mismatches according to official upgrade resources.

Can I use automated codemods for both Next.js App Router and Pages Router projects?▼

Yes, automated codemods work for both Next.js App Router and Pages Router projects. The migration process detects your current version from package.json and applies the necessary API transformations for either routing architecture.

How do I synchronize React and React-dom dependencies when updating Next.js?▼

You synchronize dependencies when updating Next.js by updating next, react, and react-dom together to compatible versions. This dependency synchronization ensures your build and runtime behavior remain stable after the migration.

Why does my Next.js build fail after a major version upgrade?▼

A Next.js build may fail after an upgrade due to deprecated APIs or configuration mismatches introduced by skipping versions. Validating the build and runtime steps incrementally catches these breaking changes early.

Related Skills

Explore More Software Engineering Skills→
raphaelandrewsraphaelandrews
1

next-upgrade

Upgrade Next.js projects by applying official codemods and verifying build stability.

Community
Intermediate
zebbernzebbern
5

next-upgrade

Automates Next.js upgrades using official migration guides and codemods.

Community
Advanced
featurectrlfeaturectrl

next-upgrade

Upgrade Next.js projects by applying official codemods and updating dependencies.

Official
Advanced
salafidurussalafidurus
1

next-upgrade

Upgrades a Next.js project to the latest stable version using official migration guides and codemods.

Official
Intermediate