next-upgrade

Automate Next.js major version upgrades with codemods and dependency updates.

Updated Apr 7, 2026
One-click install
npx skills add https://github.com/Yahia89/ordering-food --skill next-upgrade-yahia89
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: next-upgrade
Source: https://github.com/Yahia89/ordering-food/tree/main/.agents/skills/next-upgrade
Command: npx skills add https://github.com/Yahia89/ordering-food --skill next-upgrade-yahia89

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Upgrade tasks are time-consuming and error-prone due to breaking changes across Next.js versions; this skill provides a structured, codemod-guided upgrade path that follows official migration guides.

Core Features & Use Cases

  • Detects current Next.js version and related dependencies, and fetches official upgrade guides and codemods.
  • Applies codemods to automate breaking changes and updates dependencies to latest compatible versions.
  • Validates upgrades by building and testing key functionality across environments, ensuring smooth transitions.

Quick Start

Upgrade your Next.js project to the latest version by following the official migration guides and applying 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 major version safely?

To upgrade Next.js safely, this process detects your current version, fetches official migration guides, applies codemods for breaking changes, updates dependencies, and validates the transition through build and run checks.

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

Codemods are automated code transformations that apply breaking changes across your Next.js project. They are fetched from official upgrade guides to modify code structures automatically, reducing manual errors during dependency updates.

Can I upgrade a Next.js project that is multiple major versions behind?

Yes, this upgrade process is designed for projects with major version gaps in Next.js. It fetches the required official migration guides and applies the necessary codemods and dependency updates sequentially.

What is the best way to handle breaking changes when updating Next.js dependencies?

The best way to handle breaking changes is following a structured, codemod-guided upgrade path. It applies official migration guides to automate code transformations and updates dependencies to their latest compatible versions.

How are Next.js upgrades validated to ensure the build does not break?

Next.js upgrades are validated by building and testing key functionality across environments. This ensures the applied codemods and dependency updates result in a smooth transition without breaking the application.

Does this Next.js upgrade process support TypeScript projects?

Yes, this structured upgrade path supports TypeScript projects by applying codemods and official migration guides to automate breaking changes, updating dependencies, and validating the build across environments.