Next Upgrade
- 1.2k installs
- 229 repo stars
- Updated July 27, 2026
- vercel-labs/vercel-plugin
next-upgrade is an agent skill for upgrade next.js to the latest version following official migration guides and codemods. use when upgrading next.js versions, running codemods, or migrating between major releases.
About
The next-upgrade skill is designed for upgrade Next.js to the latest version following official migration guides and codemods. Use when upgrading Next.js versions, running codemods, or migrating between major releases. Upgrade Next.js Upgrade the current project to the latest Next.js version following official migration guides. Detect current version: Read package.json to identify the current Next.js version and related dependencies (React, React DOM, etc.) 2. Invoke when the user upgrading Next.
- Upgrade Next.js to the latest version following official migration guides and codemods. Use when upgrading Next.js versi
- User upgrading Next.
- Developers using next upgrade workflows documented in SKILL.md.
Next Upgrade by the numbers
- 1,161 all-time installs (skills.sh)
- Ranked #329 of 2,277 Frontend Development skills by installs in the Skillselion catalog
- Security screen: MEDIUM risk (skills.sh audit)
- Data as of Jul 28, 2026 (Skillselion catalog sync)
next-upgrade capabilities & compatibility
- Capabilities
- upgrade next.js to the latest version following · user upgrading next · developers using next upgrade workflows document
What next-upgrade says it does
Upgrade Next.js to the latest version following official migration guides and codemods. Use when upgrading Next.js versions, running codemods, or migrating between major releases.
Upgrade Next.js to the latest version following official migration guides and codemods. Use when upgrading Next.js versions, running codemods, or migrating betw
npx skills add https://github.com/vercel-labs/vercel-plugin --skill next-upgradeAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 1.2k |
|---|---|
| repo stars | ★ 229 |
| Security audit | 2 / 3 scanners passed |
| Last updated | July 27, 2026 |
| Repository | vercel-labs/vercel-plugin ↗ |
How do I upgrade next.js to the latest version following official migration guides and codemods. use when upgrading next.js versions, running codemods, or migrating between major releases?
Upgrade Next.js to the latest version following official migration guides and codemods. Use when upgrading Next.js versions, running codemods, or migrating between major releases.
Who is it for?
Developers using next upgrade workflows documented in SKILL.md.
Skip if: Skip when the task falls outside next-upgrade scope or needs a different stack.
When should I use this skill?
User upgrading Next.
What you get
Completed next-upgrade workflow with documented commands, files, and expected deliverables.
- Updated next and react dependencies
- Codemod-applied source diffs
- Build and dev server validation results
By the numbers
- Links to 3 version-specific upgrade guides: 14, 15, and 16
- Lists 3 common @next/codemod transform names in SKILL.md
Files
Upgrade Next.js
Upgrade the current project to the latest Next.js version following official migration guides.
Instructions
1. Detect current version: Read package.json to identify the current Next.js version and related dependencies (React, React DOM, etc.)
2. Fetch the latest upgrade guide: Use WebFetch to get the official upgrade documentation:
- Codemods: https://nextjs.org/docs/app/guides/upgrading/codemods
- Version-specific guides (adjust version as needed):
- https://nextjs.org/docs/app/guides/upgrading/version-16
- https://nextjs.org/docs/app/guides/upgrading/version-15
- https://nextjs.org/docs/app/guides/upgrading/version-14
3. Determine upgrade path: Based on current version, identify which migration steps apply. For major version jumps, upgrade incrementally (e.g., 13 → 14 → 15).
4. Run codemods first: Next.js provides codemods to automate breaking changes:
npx @next/codemod@latest <transform> <path>Common transforms:
next-async-request-api- Updates async Request APIs (v15)next-request-geo-ip- Migrates geo/ip properties (v15)next-dynamic-access-named-export- Transforms dynamic imports (v15)
5. Update dependencies: Upgrade Next.js and peer dependencies together:
npm install next@latest react@latest react-dom@latest6. Review breaking changes: Check the upgrade guide for manual changes needed:
- API changes (e.g., async params in v15)
- Configuration changes in
next.config.js - Deprecated features being removed
7. Update TypeScript types (if applicable):
npm install @types/react@latest @types/react-dom@latest8. Test the upgrade:
- Run
npm run buildto check for build errors - Run
npm run devand test key functionality
name: next-upgrade
description: Upgrade Next.js to the latest version following official migration guides and codemods. Use when upgrading Next.js versions, running codemods, or migrating between major releases.
metadata:
priority: 6
docs:
- "https://nextjs.org/docs/app/guides/upgrading"
- "https://nextjs.org/docs/app/guides/upgrading/codemods"
pathPatterns:
- 'next.config.*'
- 'package.json'
bashPatterns:
- '\bnpx\s+@next/codemod\b'
- '\bnpm\s+(install|i|add)\s+[^\n]*\bnext@'
- '\bpnpm\s+(install|i|add)\s+[^\n]*\bnext@'
- '\bbun\s+(install|i|add)\s+[^\n]*\bnext@'
- '\byarn\s+add\s+[^\n]*\bnext@'
promptSignals:
phrases:
- "upgrade next"
- "upgrade nextjs"
- "migrate next"
- "update next.js"
- "next.js upgrade"
- "nextjs migration"
- "next codemod"
allOf:
- [upgrade, next]
- [migrate, next]
- [update, nextjs]
anyOf:
- "breaking changes"
- "codemod"
- "migration guide"
- "version upgrade"
noneOf: []
minScore: 6
retrieval:
aliases:
- next upgrade
- nextjs migration
- next codemod
intents:
- upgrade Next.js to latest version
- run Next.js codemods
- migrate between major Next.js versions
entities:
- codemod
- migration
- upgrade
- breaking changes
chainTo:
-
pattern: 'getServerSideProps|getStaticProps|next/router|next/head|next/document'
targetSkill: nextjs
message: 'Pages Router patterns detected during upgrade — loading Next.js best practices for App Router migration.'
Related skills
Vercel React Best PracticesAutomatically apply Vercel’s official React and Next.js performance rules during code generation and review.576k29.4kVercel Composition PatternsGenerate and refactor React components that stay maintainable as complexity grows without boolean prop explosion.261k29.4k
ShadcnAdd, compose, search, fix, and style production-grade React components directly from source without leaving their editor.249k120k
Develop UserscriptsCorrectly write, debug, and package userscripts for Tampermonkey and ScriptCat with proper metadata, GM APIs, and runtime decisions.224k72
Minimalist UiGenerate clean, editorial-style web interfaces with warm monochrome palettes, typographic hierarchy, bento grids and flat components that feel premium and utilita201k66.9kVercel React Native SkillsEnsure AI agents generate and refactor React Native code that follows performance best practices without common rendering and list pitfalls.173k29.4kHow it compares
Use next-upgrade for version migration workflows; use the nextjs skill in the same plugin for ongoing App Router development after upgrade completes.
FAQ
What does next-upgrade do?
Upgrade Next.js to the latest version following official migration guides and codemods. Use when upgrading Next.js versions, running codemods, or migrating between major releases.
When should I use next-upgrade?
User upgrading Next.
Is next-upgrade safe to install?
Review the Security Audits panel on this page before installing in production.