next-upgrade

Upgrade Next.js projects to the latest version using official migration guides and codemods.

Updated Feb 1, 2026
One-click install
npx skills add https://github.com/harsh-m-patil/hermes --skill next-upgrade-harsh-m-patil
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: next-upgrade
Source: https://github.com/harsh-m-patil/hermes/tree/main/.agents/skills/next-upgrade
Command: npx skills add https://github.com/harsh-m-patil/hermes --skill next-upgrade-harsh-m-patil

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides teams to upgrade a Next.js project to the latest version following official migration guides and codemods, reducing risk and downtime.

Core Features & Use Cases

  • Official-guided upgrades: follows Next.js migration guides and codemods for smooth transitions.
  • Incremental upgrades: supports major-version jumps by upgrading stepwise (e.g., 13 → 14 → 15).
  • Automated validation: validates builds and runs the development server to ensure functional stability.

Quick Start

Run the upgrade workflow to detect the current version from package.json, fetch official upgrade documentation, apply codemods, update dependencies, and verify the build and local server is running.

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, run the automated workflow to detect your current version, fetch official migration guides, apply codemods, update dependencies, and verify the build and local server.

Can I jump multiple major Next.js versions in one upgrade?

For major Next.js version jumps, the process supports incremental upgrades, guiding you stepwise through intermediate versions like 13 to 14 to 15 to ensure a smooth transition.

How do codemods work during a Next.js migration?

Next.js migration codemods automatically transform your codebase to match new version standards, fetching official guides and applying necessary code changes before updating dependencies and validating the build.

Does the Next.js upgrade process work with app router and React dependencies?

Yes, the upgrade workflow applies to Next.js apps using the app router and React dependencies, updating them according to official migration guides and verifying functional stability.

What is the best way to verify a Next.js version upgrade?

The best way to verify a Next.js upgrade is by running automated validation checks that confirm successful builds and ensure the development server starts without errors.

How do I detect my current Next.js version before migrating?

The upgrade process automatically detects your current Next.js version by reading the package.json file, then fetches the appropriate official migration guides for your upgrade path.