next-upgrade

Upgrade Next.js projects by running official codemods and configuration fixes.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates upgrading Next.js projects across major versions by following official migration guides and codemods, reducing the manual effort of resolving breaking changes and configuration mismatches.

Core Features & Use Cases

  • Detects the current Next.js, React, and related dependency versions by reading package.json to determine an appropriate upgrade path.
  • Fetches official Next.js upgrade guides and codemods, runs recommended npx @next/codemod transforms, and updates dependencies and TypeScript types as needed.
  • Use Case: Incrementally migrate a Next.js 13 application to a newer major release by applying codemods, updating next.config.js and peer packages, and validating the build.

Quick Start

Upgrade the repository's Next.js version to the latest, run recommended codemods, update peer dependencies, and report any build or runtime errors.

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?

To upgrade Next.js safely, read package.json to detect current versions, fetch official upgrade guides, run npx @next/codemod transforms, bump React and React-DOM, adjust next.config.js, and validate the build.

What do official Next.js codemods do during a migration?

Next.js codemods automatically apply code transforms to fix breaking changes and configuration mismatches, updating TypeScript types and adjusting next.config.js while upgrading across major Next.js versions.

Do I need to update React and TypeScript dependencies when upgrading Next.js?

Yes, upgrading Next.js requires bumping React and React-DOM in package.json and updating TypeScript types to match the newer Next.js version and ensure successful build checks.

Can I incrementally migrate a Next.js 13 application to a newer major release?

You can incrementally migrate a Next.js 13 application by applying recommended codemods, updating peer packages and next.config.js, and running build and dev checks to catch runtime errors.

What is the best way to resolve breaking changes when bumping Next.js versions?

The best way to resolve breaking changes is following official Next.js migration guides, executing npx @next/codemod transforms, and adjusting next.config.js and TypeScript types to validate the build.