next-upgrade

Upgrade Next.js projects across major versions using codemods and official guides.

1|Updated Nov 1, 2025
One-click install
npx skills add https://github.com/carlosalberto05/perritos-refugio-frontend --skill next-upgrade-carlosalberto05
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: next-upgrade
Source: https://github.com/carlosalberto05/perritos-refugio-frontend/tree/main/.agents/skills/next-upgrade
Command: npx skills add https://github.com/carlosalberto05/perritos-refugio-frontend --skill next-upgrade-carlosalberto05

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Upgrading Next.js to the latest version can be error-prone due to breaking changes, deprecated APIs, and dependencies drift. This Skill provides a structured upgrade workflow aligned with official docs and codemods to reduce friction and ensure a smooth transition.

Core Features & Use Cases

  • Detects current Next.js version and related dependencies from package.json.
  • Guides incremental upgrades across major versions using codemods and official migration guides.
  • Updates dependencies and TS types as needed and validates build and dev server.

Quick Start

Identify the current Next.js version and initiate the upgrade workflow using the official 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 version safely?

To upgrade Next.js safely, detect your current version from package.json, apply official codemods, update dependencies, review breaking changes, and run builds and tests to validate the migration.

What is the best way to handle Next.js breaking changes during a major version upgrade?

Handling Next.js breaking changes involves following official upgrade guides and applying codemods to automate API migrations, ensuring your project aligns with the latest version requirements smoothly.

How do I use codemods for a Next.js migration?

Codemods automate code transformations during a Next.js migration by updating deprecated APIs and syntax, reducing manual errors while aligning your codebase with the target version's requirements.

Can I upgrade Next.js incrementally across multiple major versions?

Yes, you can upgrade Next.js incrementally by following multi-step version upgrades, applying codemods and official migration guides sequentially to bridge major releases without breaking your project.

Why does my Next.js build fail after updating dependencies?

A Next.js build may fail after updating dependencies due to deprecated APIs or dependency drift; running builds and tests post-upgrade helps identify breaking changes that require codemod application or manual fixes.