next-upgrade

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

1.4k|162|Updated Sep 5, 2025
One-click install
npx skills add https://github.com/inkeep/agents --skill next-upgrade-inkeep
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: next-upgrade
Source: https://github.com/inkeep/agents/tree/main/.agents/skills/next-upgrade
Command: npx skills add https://github.com/inkeep/agents --skill next-upgrade-inkeep

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides developers through upgrading a Next.js project to the latest version by following official migration guides and codemods, minimizing manual guesswork and potential breakages.

Core Features & Use Cases

  • Detects the current Next.js version and related dependencies in package.json.
  • Fetches official upgrade guides and codemods and applies them to perform automated transformations.
  • Supports incremental upgrades across major versions and validates results with builds and tests.

Quick Start

Run this skill to upgrade your Next.js project to the latest release following codemods and 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?

To upgrade Next.js safely, this skill detects your current version in package.json, fetches official migration guides, and applies Next.js codemods to automate transformations. It guides you through incremental upgrades across major versions and validates results with builds and tests.

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

Next.js codemods are automated transformation tools accessed via npx @next/codemod. They apply code changes to your project based on official migration guides, minimizing manual guesswork and potential breakages during the Next.js version upgrade process.

Can I upgrade Next.js across multiple major versions incrementally?

Yes, you can upgrade Next.js incrementally across major versions. The skill supports incremental upgrades by fetching the relevant official upgrade guides and applying the necessary codemods for each step, validating results with builds and tests along the way.

Do I need access to package.json to upgrade my Next.js project?

Yes, access to package.json is required to upgrade your Next.js project. The skill uses package.json to detect the current Next.js version and related dependencies, which is necessary before applying official migration guides and codemods.

What's the best way to apply official Next.js migration guides automatically?

The best way to apply official Next.js migration guides automatically is by using this skill to fetch the documentation and run the Next.js codemods tooling. This minimizes manual guesswork by performing automated transformations on your project files.

Why should I use automated codemods instead of manually updating my Next.js project?

Using automated codemods instead of manually updating your Next.js project minimizes potential breakages and guesswork. The skill fetches official upgrade guides and applies transformations automatically, ensuring a safer migration by validating results with builds and tests.