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.