next-upgrade

Automated Next.js version upgrades with official codemods and migration guide integration. Detects current Next.js version from package.json and fetches version-specific upgrade documentation from official guides Runs Next.js codemods automatically to handle breaking changes like async Request APIs, geo/IP property migrations, and dynamic import transformations Handles incremental upgrades for major version jumps (e.g., 13 → 14 → 15) and updates peer dependencies (React, React DOM, TypeScript types) in a single step Validates upgrades by running build and dev commands to catch errors before completion

INSTALLATION
npx skills add https://github.com/vercel-labs/next-skills --skill next-upgrade
Run in your project or agent environment. Adjust flags if your CLI version differs.

SKILL.md

$2a

-

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)

-

Update dependencies: Upgrade Next.js and peer dependencies together:

npm install next@latest react@latest react-dom@latest

-

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

-

Update TypeScript types (if applicable):

npm install @types/react@latest @types/react-dom@latest

-

Test the upgrade:

  • Run npm run build to check for build errors
  • Run npm run dev and test key functionality
BrowserAct

Let your agent run on any real-world website

Bypass CAPTCHA & anti-bot for free. Start local, scale to cloud.

Explore BrowserAct Skills →

Stop writing automation&scrapers

Install the CLI. Run your first Skill in 30 seconds. Scale when you're ready.

Start free
free · no credit card