name: next-upgrade
description: Upgrade Next.js to the latest version following official migration guides and codemods
argument-hint: "[target-version]"
Upgrade Next.js
Upgrade the current project to the latest Next.js version following official migration guides.
Instructions
Detect current version: Read package.json to identify the current Next.js version and related dependencies (React, React DOM, etc.)
Fetch the latest upgrade guide: Use WebFetch to get the official upgrade documentation:
Determine upgrade path: Based on current version, identify which migration steps apply. For major version jumps, upgrade incrementally (e.g., 13 → 14 → 15).
Run codemods first: Next.js provides codemods to automate breaking changes:
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: georgekhananaev-claude-skills-vault-next-upgrade3description: ---4---5---6name: next-upgrade7description: Upgrade Next.js to the latest version following official migration guides and codemods8argument-hint: "[target-version]"9---1011# Upgrade Next.js1213Upgrade the current project to the latest Next.js version following official migration guides.1415## Instructions16171. **Detect current version**: Read `package.json` to identify the current Next.js version and related dependencies (React, React DOM, etc.)18192. **Fetch the latest upgrade guide**: Use WebFetch to get the official upgrade documentation:20 - Codemods: https://nextjs.org/docs/app/building-your-application/upgrading/codemods21 - Version-specific guides (adjust version as needed):22 - https://nextjs.org/docs/app/building-your-application/upgrading/version-1523 - https://nextjs.org/docs/app/building-your-application/upgrading/version-1424253. **Determine upgrade path**: Based on current version, identify which migration steps apply. For major version jumps, upgrade incrementally (e.g., 13 → 14 → 15).26274. **Run codemods first**: Next.js provides codemods to automate breaking changes:28 ```bash29 npx @next/codemod@latest <transform> <path>30 ```31 Common transforms:32 - `next-async-request-api` - Updates async Request APIs (v15)33 - `next-request-geo-ip` - Migrates geo/ip properties (v15)34 - `next-dynamic-access-named-export` - Transforms dynamic imports (v15)35365. **Update dependencies**: Upgrade Next.js and peer dependencies together:37 ```bash38 npm install next@latest react@latest react-dom@latest39 ```40416. **Review breaking changes**: Check the upgrade guide for manual changes needed:42 - API changes (e.g., async params in v15)43 - Configuration changes in `next.config.js`44 - Deprecated features being removed45467. **Update TypeScript types** (if applicable):47 ```bash48 npm install @types/react@latest @types/react-dom@latest49 ```50518. **Test the upgrade**:52 - Run `npm run build` to check for build errors53 - Run `npm run dev` and test key functionality5455---56> Converted and distributed by [TomeVault](https://tomevault.io/claim/georgekhananaev) — claim your Tome and manage your conversions.57<!-- tomevault:4.0:skill_md:2026-04-12 -->
Run npx skillmds@latest add tomevault-io/georgekhananaev-claude-skills-vault-next-upgrade in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
--- It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.
tomevault-io