next-upgrade

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

1|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/arthtyagi/onloop --skill next-upgrade-arthtyagi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: next-upgrade
Source: https://github.com/arthtyagi/onloop/tree/main/.agents/skills/next-upgrade
Command: npx skills add https://github.com/arthtyagi/onloop --skill next-upgrade-arthtyagi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you move a Next.js project to a newer major or latest version without guessing at breaking changes, mismatched dependencies, or missed migration steps.

Core Features & Use Cases

  • Version Detection: Checks the current Next.js, React, and React DOM versions before planning the upgrade path.
  • Official Migration Workflow: Uses the latest official Next.js upgrade guides and codemods to handle breaking changes in a predictable order.
  • Dependency Alignment and Validation: Updates related packages, reviews manual migration steps, and verifies the upgrade through build and runtime checks.

Quick Start

Upgrade this project to the latest Next.js version using the official migration guides and codemods, then run the build to confirm everything still works.

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 using official migration guides?

To upgrade Next.js, the workflow detects your current versions, applies official codemods to handle breaking changes, updates dependencies, and verifies the migration through build and runtime testing.

What are codemods and when do I need them for a Next.js migration?

Codemods are automated code transformations used during a Next.js migration to automatically fix breaking changes. They must be applied before updating your packages to ensure version-to-version compatibility.

How do I align React and React DOM dependencies when upgrading Next.js?

Dependency alignment occurs after initial version detection. The upgrade process updates related packages like React and React DOM alongside Next.js to prevent mismatched dependencies and runtime errors.

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

The best way to handle breaking changes is using the official Next.js upgrade guides and codemods. This approach applies automated fixes in a predictable order before package updates and validates success with a build.

Does the Next.js upgrade workflow work for production web applications?

Yes, the Next.js upgrade workflow is designed for production web applications. It uses official migration guides, aligns dependencies, and verifies success through comprehensive build and runtime testing.

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

A Next.js build often fails after a manual upgrade due to missed migration steps or mismatched dependencies. Using official codemods before package updates and verifying with a build prevents these errors.