next-upgrade

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Upgrading Next.js projects to the latest major/minor versions can be error-prone due to breaking changes, deprecated APIs, and compatibility requirements across React and related tooling.

Core Features & Use Cases

  • Guided version upgrades: Determines the current Next.js and React versions and suggests a safe upgrade path through incremental steps.
  • Automated codemods & dependency updates: Runs official codemods and updates Next.js, React, and React DOM to compatible versions.
  • Manual review checkpoints: Highlights breaking changes and config changes to adjust next.config.js or TypeScript types as needed.
  • Use Case: You have a Next.js project stuck on v13 and need to reach v15 with minimal manual changes.

Quick Start

Upgrade your Next.js project to the latest version by following the plan and running the codemods and dependency updates as directed.

Frequently Asked Questions about next-upgrade

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

FAQPage Schema
How do I upgrade a Next.js project to the latest version safely?

Upgrading Next.js safely involves detecting current versions, applying official codemods, updating React and Next.js dependencies, and adjusting configurations. This skill automates that workflow while providing manual review checkpoints for breaking changes.

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

Codemods are automated code transformation tools that update deprecated APIs during a Next.js migration. This skill fetches and runs official Next.js codemods automatically to handle breaking changes across your project files.

Can I upgrade Next.js from version 13 to 15 automatically?

Yes, you can upgrade Next.js from v13 to v15 incrementally. The skill determines your current version, fetches applicable migration guides, runs official codemods, and updates dependencies to reach the latest version with minimal manual intervention.

Does the Next.js upgrade process also update React dependencies?

Yes, the Next.js upgrade process updates React and React DOM to compatible versions. Alongside running codemods, the skill adjusts dependency packages and TypeScript types to ensure compatibility across the upgraded tooling stack.

What breaking changes do I need to adjust manually during a Next.js migration?

During a Next.js migration, you need to manually adjust next.config.js and TypeScript types after reviewing highlighted breaking changes. The skill automates codemods and dependency updates but enforces manual review checkpoints for configuration adjustments.

How does a version-aware upgrade validate the final Next.js build?

A version-aware upgrade validates the final Next.js build by running builds and tests after applying codemods and configuration adjustments. This ensures the upgraded project, including React and TypeScript types, functions correctly without runtime errors.