next-upgrade

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

146|12|Updated Jan 30, 2025
One-click install
npx skills add https://github.com/zoonk/zoonk --skill next-upgrade-zoonk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: next-upgrade
Source: https://github.com/zoonk/zoonk/tree/main/.agents/skills/next-upgrade
Command: npx skills add https://github.com/zoonk/zoonk --skill next-upgrade-zoonk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Upgrade Next.js projects to the latest version by following official migration guides and codemods, reducing manual risk and drift.

Core Features & Use Cases

  • Guided upgrade paths across major versions (e.g., 13 → 14 → 15) with stepwise compatibility checks.
  • Codemod automation to apply breaking changes automatically and minimize manual edits.
  • Dependency synchronization and validation through build/test cycles to ensure stability after upgrade.
  • Use Case: Teams migrating a large Next.js project with App Router, middleware, and custom server logic.

Quick Start

Run the upgrade workflow to migrate your Next.js project to the latest version following 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 using codemods?

To upgrade Next.js to the latest version, this workflow detects your current version from package.json, fetches official migration guides, executes codemods to apply breaking changes automatically, and updates dependencies. It supports incremental version jumps across App Router and Pages architectures.

Can I migrate a Next.js project with App Router and custom server logic?

Yes, you can migrate Next.js projects using App Router, middleware, and custom server logic. The workflow applies official migration guides and codemod-driven changes to handle breaking changes automatically, minimizing manual edits for complex project architectures.

What is the best way to handle Next.js major version upgrades incrementally?

The best way to handle Next.js major version upgrades is through stepwise compatibility checks. This workflow guides you through incremental version jumps, such as migrating from 13 to 14 to 15, applying codemods and validating builds at each step to ensure stability.

Do I need to update TypeScript types after a Next.js migration?

Yes, you may need to perform optional TypeScript type updates after a Next.js migration. The workflow executes codemods, updates dependencies, validates builds through test cycles, and performs these optional type updates to ensure your TypeScript project remains stable.

Why does my Next.js build break after upgrading dependencies manually?

Your Next.js build may break after manual upgrades due to missed breaking changes. This workflow prevents drift by applying official codemods automatically, synchronizing dependencies, and validating build and test cycles to ensure stability after the upgrade.