next-upgrade

Upgrade Next.js projects using official migration guides and codemods.

Updated May 31, 2026
One-click install
npx skills add https://github.com/ChristineTham/lp --skill next-upgrade-christinetham
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: next-upgrade
Source: https://github.com/ChristineTham/lp/tree/main/.agents/skills/next-upgrade
Command: npx skills add https://github.com/ChristineTham/lp --skill next-upgrade-christinetham

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Upgrade Next.js projects to the latest version following official migration guides and codemods, to minimize breaking changes and keep apps current.

Core Features & Use Cases

  • Automates the Next.js upgrade process by applying codemods and updating dependencies across major versions.
  • Fetches official migration guides and codemod references to guide incremental upgrades.
  • Handles project readiness checks (build, dev) and surfaces required manual adjustments in next.config.js or API changes.

Quick Start

Detect your current Next.js version and run the guided upgrade workflow to migrate to the latest release.

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, use official migration guides and apply codemods to automate codebase changes and update dependencies across major versions. This minimizes breaking changes and keeps your project current.

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

Codemods automate the codebase changes required during a Next.js migration by applying official transformations. They handle dependency updates and syntax modifications to minimize breaking changes across major versions.

Can I use this guided workflow for major Next.js version upgrades?

Yes, this guided workflow specifically targets major Next.js version upgrades. It fetches official migration references to guide incremental upgrades and handles required project readiness checks.

What is the best way to handle breaking changes in next.config.js during a Next.js upgrade?

The best way to handle breaking changes in next.config.js during a Next.js upgrade is to use a guided workflow that surfaces required manual adjustments and verifies configurations through build and dev runs.

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

A Next.js build may fail after a version upgrade due to unresolved breaking changes or outdated API usage. Running the guided upgrade workflow applies codemods and surfaces manual adjustments needed for compatibility.