next-upgrade

Upgrade Next.js applications using version-aware codemods and migration guidance.

Updated Apr 11, 2026
One-click install
npx skills add https://github.com/BrunoAlpezdev/lluvia-de-ideas --skill next-upgrade-brunoalpezdev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: next-upgrade
Source: https://github.com/BrunoAlpezdev/lluvia-de-ideas/tree/main/.agents/skills/next-upgrade
Command: npx skills add https://github.com/BrunoAlpezdev/lluvia-de-ideas --skill next-upgrade-brunoalpezdev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Upgrading Next.js often breaks builds due to dependency changes, codemods, and version-specific migration steps, forcing teams to debug issues manually.

Core Features & Use Cases

  • Current version detection: Reads package.json to determine the existing Next.js and related React dependencies before choosing the right migration path.
  • Official guide + codemod driven migration: Pulls the relevant Next.js upgrade guidance and applies recommended codemods to automate common breaking-change updates.
  • Dependency and compatibility updates: Updates Next.js and peer dependencies together, then addresses TypeScript-related type alignment when applicable.
  • Use case: When moving a production app from Next.js 14 to 15, this Skill helps you apply codemods, update dependencies, check for required manual changes, and verify the upgrade through build and runtime testing.

Quick Start

Ask: Upgrade my project to the latest Next.js version by following the official migration guides, applying the relevant codemods, and verifying the result with a build and dev run.

Frequently Asked Questions about next-upgrade

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upgrade my Next.js application to the latest version safely?

Safely upgrading Next.js involves detecting the current version from package.json, selecting the correct upgrade path, running @next/codemod transforms, updating dependencies, and validating the result through build and dev testing.

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

Codemods are automated code transformation tools that apply recommended breaking-change updates during a Next.js migration, reducing the need to manually debug dependency and configuration changes across major releases.

Does upgrading Next.js require updating React and React DOM as well?

Yes, upgrading Next.js requires updating related React and React DOM peer dependencies together, and this Skill also addresses TypeScript-related type alignment when applicable to ensure compatibility across major releases.

Can I use this to migrate a production app from Next.js 14 to 15?

Yes, you can use this Skill for a production app moving from Next.js 14 to 15, as it applies the necessary codemods, updates dependencies, checks for required manual breaking changes, and verifies the upgrade through runtime testing.

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

Next.js builds often break after an upgrade due to dependency changes and version-specific migration steps, so this Skill targets production dependency and configuration migrations to resolve these breaking changes automatically.