next-upgrade

Automate Next.js project migrations by executing official codemods and updating peer dependencies.

214|7|Updated May 29, 2026
One-click install
npx skills add https://github.com/anolilab/lunora --skill next-upgrade-anolilab
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: next-upgrade
Source: https://github.com/anolilab/lunora/tree/main/.agents/skills/next-upgrade
Command: npx skills add https://github.com/anolilab/lunora --skill next-upgrade-anolilab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill simplifies the complex and error-prone process of upgrading Next.js projects by automating dependency updates and applying official codemods to handle breaking changes.

Core Features & Use Cases

  • Automated Codemods: Executes official Next.js transformation scripts to update code patterns for new major versions.
  • Dependency Synchronization: Ensures Next.js, React, and TypeScript types are upgraded to compatible versions simultaneously.
  • Use Case: When migrating a large codebase from Next.js 13 to 15, use this Skill to automatically apply the necessary async request API transforms and update all peer dependencies to prevent build-time failures.

Quick Start

Use the next-upgrade skill to update the current project to the latest stable version of Next.js.

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 automatically?▼

You can automate a Next.js upgrade by executing official codemods and updating peer dependencies like React and TypeScript types simultaneously to resolve breaking changes across the project.

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

Next.js codemods are official transformation scripts that automatically update code patterns for new major versions. You need them during migrations to handle breaking changes like async request API transforms.

Can I use this Next.js migration tool to update TypeScript dependencies?▼

Yes, this Next.js migration tool synchronizes dependency updates by ensuring Next.js, React, and TypeScript types are upgraded to compatible versions simultaneously to prevent build-time failures.

What is the best way to handle Next.js breaking changes in a large codebase?▼

The best way to handle Next.js breaking changes in a large codebase is applying automated transformation scripts to update code patterns and synchronizing all peer dependencies automatically.

Does this Next.js migration tool require access to my project file system?▼

Yes, the migration process requires file system access to modify package.json and execute npx commands for running the official Next.js transformation scripts.

Why should I not manually upgrade Next.js without codemods?▼

Manually upgrading Next.js without codemods is complex and error-prone because you must individually resolve breaking changes and manually verify peer dependency compatibility across the entire codebase.