next-upgrade

Automates Next.js upgrades using official migration guides and codemods.

5|3|Updated Apr 10, 2026
One-click install
npx skills add https://github.com/zebbern/termstack --skill next-upgrade-zebbern
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: next-upgrade
Source: https://github.com/zebbern/termstack/tree/main/.github/skills/next-upgrade
Command: npx skills add https://github.com/zebbern/termstack --skill next-upgrade-zebbern

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Upgrading Next.js across projects can be error-prone due to major version gaps, manual configuration changes, and compatibility concerns. This Skill automates guidance and codemods, ensuring upgrades follow official migration paths.

Core Features & Use Cases

  • Detects the current Next.js version and related dependencies (React, React DOM, etc.).
  • Fetches and interprets official upgrade guides and codemods for the target version.
  • Applies incremental upgrades, updates dependencies, and validates builds and runtime behavior.

Quick Start

Follow the steps to upgrade your Next.js project to the latest version using codemods and official migration guides.

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?

Upgrading Next.js safely involves detecting the current version, fetching official migration guides, applying codemods incrementally, updating dependencies, and validating builds. This Skill enforces manual review of breaking changes before deployment to ensure a safe upgrade.

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

Codemods are automated code transformation tools used during Next.js migration. This Skill applies official codemods to safely update your codebase, adjusting configurations and TypeScript typings automatically while handling breaking changes across version gaps.

Can I use this to upgrade a Next.js project with major version gaps?

Yes, this Skill supports upgrading Next.js projects with major version gaps. It performs incremental upgrades, fetches target-version official materials, and updates related dependencies like React and React DOM to resolve compatibility concerns.

Does the Next.js upgrade process update React and related dependencies?

Yes, the upgrade process detects and updates related dependencies including React and React DOM. This Skill ensures connected packages are updated alongside the framework, adjusting TypeScript typings and validating runtime behavior.

What should I check for breaking changes before deploying a Next.js upgrade?

Before deploying a Next.js upgrade, manually review breaking changes identified by official migration guides. This Skill enforces this review process, validates builds, and checks runtime behavior to ensure deployment safety.