next-upgrade

Upgrade Next.js projects by applying official codemods and updating dependencies.

Updated Apr 24, 2026
One-click install
npx skills add https://github.com/featurectrl/website --skill next-upgrade-featurectrl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: next-upgrade
Source: https://github.com/featurectrl/website/tree/main/.claude/skills/next-upgrade
Command: npx skills add https://github.com/featurectrl/website --skill next-upgrade-featurectrl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Upgrades Next.js projects to the latest official version, ensuring alignment with official migration guides and codemods to minimize manual effort and risk.

Core Features & Use Cases

  • Automates detection of the current Next.js version and related dependencies from package.json.
  • Fetches official upgrade guides and codemods, and determines an incremental upgrade path for major version jumps.
  • Applies codemods and updates dependencies, then guides manual review of breaking changes and configuration updates.

Quick Start

Run the upgrade workflow on your Next.js project by first detecting the current version from package.json, then applying official codemods and updating dependencies.

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?

You can upgrade Next.js safely by aligning dependencies with official migration guides and applying codemods to automate breaking changes. This workflow updates Next.js, React, and React DOM packages incrementally to minimize manual effort and risk.

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

Codemods are automated code transformation tools used during a Next.js migration to automatically update deprecated APIs and syntax. The skill fetches official codemods to apply these changes, reducing manual code review effort when jumping between major versions.

Can I skip major versions when upgrading Next.js dependencies?

Skipping major versions during a Next.js upgrade is not recommended. The skill determines an incremental upgrade path for major version jumps, ensuring you apply the correct codemods and review breaking changes sequentially before moving to the next release.

Does the Next.js upgrade process update React and React DOM as well?

Yes, the Next.js upgrade process includes updating React and React DOM packages. The skill detects your current versions from package.json and aligns all related dependencies with official guidance before validating the build.

What should I do after running Next.js codemods and updating dependencies?

After running Next.js codemods and updating dependencies, you should manually review breaking changes and update configuration files. The skill guides this review process and runs build validations to ensure the upgraded project functions correctly.