next-upgrade

Upgrade Next.js projects by applying official codemods and verifying build stability.

1|1|Updated May 15, 2025
One-click install
npx skills add https://github.com/raphaelandrews/fsx --skill next-upgrade-raphaelandrews
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: next-upgrade
Source: https://github.com/raphaelandrews/fsx/tree/main/.agents/skills/next-upgrade
Command: npx skills add https://github.com/raphaelandrews/fsx --skill next-upgrade-raphaelandrews

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Upgrading Next.js can introduce breaking changes and compatibility issues; this Skill guides you through a safe, step-by-step upgrade using official migration guides and codemods to minimize manual rework.

Core Features & Use Cases

  • Detect current Next.js and related dependencies (React, React DOM) to plan the upgrade.
  • Retrieve official migration guides and codemods and determine an incremental path for major version jumps.
  • Apply automated codemods followed by dependency updates, verification, and validation to ensure build and runtime stability.

Quick Start

Run the upgrade workflow to progressively migrate your Next.js project to the latest version using official guides and codemods.

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 a newer version safely?

To upgrade Next.js safely, identify your current version and related dependencies, then apply official codemods and update dependencies incrementally to verify build and runtime stability.

What is the best way to migrate Next.js across multiple major versions?

Migrating Next.js across major versions requires determining an incremental upgrade path, fetching official migration guides, and applying codemods step by step to minimize breaking changes and manual rework.

Can I use codemods to update React and React DOM when upgrading Next.js?

Yes, the upgrade workflow assesses dependencies like React and React DOM from package.json and applies official codemods alongside Next.js updates to ensure compatibility.

How do codemods work for Next.js version migrations?

Codemods automate code transformations based on official upgrade guides, modifying your codebase to match the target Next.js version requirements before you run manual reviews and tests.

Do I need to manually verify builds after applying Next.js codemods?

Yes, after applying codemods and updating dependencies, you must verify build and runtime stability across environments using tests and manual review to catch any remaining compatibility issues.