explainx.ainewsletter3.02k
Frontend

next-upgrade▌

vercel-labs/next-skills · updated Apr 8, 2026

$npx skills add https://github.com/vercel-labs/next-skills --skill next-upgrade
0 commentsdiscussion
summary

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, T
skill.md

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:

  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@latest

  6. 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@latest

  8. Test the upgrade:

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

Discussion

Product Hunt–style comments (not star reviews)
  • No comments yet — start the thread.
general reviews

Ratings

4.6★★★★★61 reviews
  • ★★★★★Neel Ndlovu· Dec 28, 2024

    We added next-upgrade from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.

  • ★★★★★Dhruvi Jain· Dec 16, 2024

    Solid pick for teams standardizing on skills: next-upgrade is focused, and the summary matches what you get after install.

  • ★★★★★James White· Dec 16, 2024

    next-upgrade reduced setup friction for our internal harness; good balance of opinion and flexibility.

  • ★★★★★Nikhil Nasser· Dec 12, 2024

    next-upgrade has been reliable in day-to-day use. Documentation quality is above average for community skills.

  • ★★★★★Naina Ndlovu· Nov 19, 2024

    Solid pick for teams standardizing on skills: next-upgrade is focused, and the summary matches what you get after install.

  • ★★★★★Oshnikdeep· Nov 7, 2024

    We added next-upgrade from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.

  • ★★★★★Zara Chawla· Nov 7, 2024

    I recommend next-upgrade for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.

  • ★★★★★Chinedu Wang· Nov 3, 2024

    next-upgrade fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.

  • ★★★★★Ganesh Mohane· Oct 26, 2024

    next-upgrade fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.

  • ★★★★★Chinedu Li· Oct 26, 2024

    Useful defaults in next-upgrade — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.

showing 1-10 of 61

1 / 7