Next.js version migrations using official guides and codemods.

MITAuto-check passedDevelopment

Install Nextjs Upgrade

skills CLI
$ npx skills add HoangNguyen0403/agent-skills-standard --skill nextjs-upgrade -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install HoangNguyen0403/agent-skills-standard nextjs-upgrade --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/HoangNguyen0403/agent-skills-standard.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/nextjs/nextjs-upgrade .claude/skills/nextjs-upgrade && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
nextjs-upgrade
GitHub stars
572
Token cost
~610 tokens
SKILL.md length
272 words
Files
3 (incl. references)
Skills in repo
211
Repo updated
First seen
Licence
MIT

At a glance

Next.js version migrations using official guides and codemods.

  • Works in 8 steps: Check current versions of next, react,… → Plan incremental path (e.g., v13 -> v14… → Run codemods: npx @next/codemod@latest → …
  • Migrating a Next.js project to a new major version using codemods
  • SKILL.md covers Priority: P1 (HIGH), Workflow: Upgrade Next.js to…, Implementation Guidelines and Anti-Patterns, plus 1 more section
  • Calls npx

What it does

Nextjs Upgrade is an agent skill from HoangNguyen0403/agent-skills-standard. Next.js version migrations using official guides and codemods. Use when migrating a Next.js project to a new major version using codemods.

Its SKILL.md is about 610 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `evals/evals.json` and `references/example.md`).

It sits in Development, covering Code migrations. It works with Next.js and React. The repository describes itself as: A collection of Agent Skills Standard and Best Practice for Programming Languages, Frameworks that help our AI Agent follow best practies on frameworks and programming laguages. The licence is MIT.

When your agent uses it

  • Migrating a Next.js project to a new major version using codemods
  • Tasks that involve Code migrations

Example prompts

  • “/nextjs-upgrade”

Requirements

  • Node.js

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. Check current versions of next, react, react-dom in package.json
  2. Plan incremental path (e.g., v13 -> v14 -> v15; never skip majors)
  3. Run codemods: npx @next/codemod@latest
  4. Update dependencies
  5. Verify async APIs: ensure cookies(), headers(), params awaited (v15+)
  6. Audit fetch caching: v15 defaults to no-store; add force-cache where needed
  7. Run next build and fix hydration or Turbopack errors
  8. Report codemod failures or manual fixes to team

What it can do on your machine

Read from SKILL.md and the folder at commit b529c2d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Nextjs Upgrade loads about 610 tokens when it runs, and up to ~660 if it reads all its reference files. Until then it costs about 38 tokens; SKILL.md has 272 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~38
When it runs · the whole SKILL.md, loaded when a task matches
~610
With references · SKILL.md plus every file in references/, read only if the agent opens them
~660

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from HoangNguyen0403/agent-skills-standard at commit b529c2d, republished under its MIT licence (© HoangNguyen0403). 272 words, ~610 tokens.

Download SKILL.mdSave it as .claude/skills/nextjs-upgrade/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
nextjs-upgrade
description
Next.js version migrations using official guides and codemods. Use when migrating a Next.js project to a new major version using codemods.

Next.js Upgrade Protocol

Automated and manual migration steps for Next.js version upgrades (e.g., v14 to v15).

Priority: P1 (HIGH)

Workflow: Upgrade Next.js to New Major Version

  1. Check current versions of next, react, react-dom in package.json
  2. Plan incremental path (e.g., v13 -> v14 -> v15; never skip majors)
  3. Run codemods: npx @next/codemod@latest <transform> <path>
  4. Update dependencies: See implementation examples
  5. Verify async APIs: ensure cookies(), headers(), params awaited (v15+)
  6. Audit fetch caching: v15 defaults to no-store; add force-cache where needed
  7. Run next build and fix hydration or Turbopack errors
  8. Report codemod failures or manual fixes to team

Implementation Guidelines

  • Upgrade Detection: Always check package.json for versions of next, react, and react-dom.
  • Planning: For major version jumps (v13 to v15), perform incremental upgrade (v13 -> v14, then v14 -> v15). Follow official Next.js Migration Guides.
  • Automated Codemods: Use npx @next/codemod@latest <transform> <path> to automate syntax migration.
  • Breaking Changes (v15): Respond to next-async-request-api transform by ensuring params, searchParams, cookies(), and headers() awaited.
  • React Parity: Upgrade react and react-dom to match Next.js peer dependencies (e.g., React 19 for Next.js 15).
  • Validation: Run next dev and next build after each incremental step. Check console errors for hydration warnings.

Anti-Patterns

  • No major version skipping: Upgrade one major version at time (13 -> 14, then 14 -> 15).
  • No manual breaking-change fixes: Always run npx @next/codemod@latest transforms first.
  • No assumed caching behavior post-upgrade: v15 defaults to no-store; audit all fetch calls.
  • No async page functions in Pages Router: export default async function Page() fatal.

Canonical response anchors

When this skill applies, preserve the following domain terminology or equivalent concrete examples in the answer when relevant:

  • incremental
  • one major

© HoangNguyen0403, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in skills/nextjs/nextjs-upgrade of HoangNguyen0403/agent-skills-standard.

  • SKILL.md
  • evals/evals.json
  • references/example.md

Open the folder on GitHubat commit b529c2d

Compare with similar skills

Nextjs Upgrade next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Nextjs Upgrade compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Nextjs Upgrade this skillHoangNguyen0403/agent-skills-standard572—~610Automated safety check: PassMIT
Next Cache Components Adoptionvercel/next.js143k6 repos~8.3kAutomated safety check: PassMIT
Chakra UI v2 to v3 Migrationchakra-ui/chakra-ui41k—~3.4kAutomated safety check: PassMIT
Next Best Practicesvercel-labs/openreview1.7k18 repos~1kAutomated safety check: PassNone
Nuqstrycompai/crm11k1 repos~1.7kAutomated safety check: PassMIT
Next Upgradevercel-labs/openreview1.7k6 repos~502Automated safety check: PassNone

Similar skills

  • Official

    Turn on Cache Components in a Next.js app and resolve the blocking routes it surfaces.

    143k GitHub starsUsed in 6 repos~8.3k tokens
    DevelopmentAuto-check passed
  • Chakra UI v2 to v3 Migration

    chakra-ui/chakra-ui

    Guides an upgrade from Chakra UI v2 to v3: inspect the project, swap packages, run the official codemod, then fix provider, color mode, props, theming and Next.js code.

    41k GitHub stars~3.4k tokensUpdated 4 days ago
    Frontend & DesignAuto-check passed
  • Next Best Practices

    vercel-labs/openreview

    Official

    Next.js best practices - file conventions, RSC boundaries, data patterns, async APIs, metadata, error handling, route handlers, image/font optimization, bundling

    1.7k GitHub starsUsed in 18 repos~1k tokens
    DevelopmentAuto-check passed
  • Nuqs

    trycompai/crm

    nuqs (type-safe URL query state) best practices for Next.js and other React frameworks.

    11k GitHub starsUsed in 1 repo~1.7k tokens
    DevelopmentAuto-check passed
  • Next Upgrade

    vercel-labs/openreview

    Official

    Upgrade Next.js to the latest version following official migration guides and codemods

    1.7k GitHub starsUsed in 6 repos~502 tokens
    DevelopmentAuto-check passed
  • Ultracite

    agustinusnathaniel/nextarter-tailwind

    Ultracite is a zero-config linting and formatting preset for JavaScript/TypeScript projects.

    125 GitHub starsUsed in 2 repos~1.2k tokens
    DevelopmentAuto-check passed

More from HoangNguyen0403/agent-skills-standard

All 211 skills in this repo
  • Subagent-Driven Development

    HoangNguyen0403/agent-skills-standard

    Runs a multi-task implementation plan by sending each task to a fresh implementer subagent, reviewing it independently, then reviewing the whole branch.

    572 GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • draw.io Architecture Diagramming

    HoangNguyen0403/agent-skills-standard

    Draws architecture diagrams as editable draw.io files from a JSON spec, with a fixed house style, one C4 level per diagram and evidence-tagged shapes.

    572 GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Android Navigation 3 Guide

    HoangNguyen0403/agent-skills-standard

    Implements and migrates to Jetpack Navigation 3 in Compose: NavDisplay, typed route objects, a state-list back stack, deep links, multiple back stacks and dialog scenes.

    572 GitHub stars~687 tokensUpdated yesterday
    Auto-check passed
  • Angular HttpClient Standards

    HoangNguyen0403/agent-skills-standard

    Sets rules for Angular HTTP code: functional interceptors, typed requests, services that own every call, and httpResource for reactive data loading in Angular 17+.

    572 GitHub stars~652 tokensUpdated yesterday
    Auto-check passed
  • Angular Tooling

    HoangNguyen0403/agent-skills-standard

    Angular CLI usage, code generation, build configuration, and bundle optimization.

    572 GitHub stars~743 tokensUpdated yesterday
    Auto-check passed
  • Common Code Review

    HoangNguyen0403/agent-skills-standard

    Conduct high-quality, persona-driven code reviews. An agent skill from HoangNguyen0403/agent-skills-standard.

    572 GitHub stars~772 tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about Nextjs Upgrade

What does Nextjs Upgrade do?

Next.js version migrations using official guides and codemods. Nextjs Upgrade is an agent skill from HoangNguyen0403/agent-skills-standard.js version migrations using official guides and codemods.

When should I use Nextjs Upgrade?

Nextjs Upgrade fits situations like: migrating a Next.js project to a new major version using codemods; tasks that involve Code migrations.

How do I install Nextjs Upgrade in Claude Code?

Run `npx skills add HoangNguyen0403/agent-skills-standard --skill nextjs-upgrade -a claude-code`. Or copy the skill folder (skills/nextjs/nextjs-upgrade in HoangNguyen0403/agent-skills-standard) into .claude/skills/nextjs-upgrade in your project. Claude Code loads it when a task matches its description.

How do I install Nextjs Upgrade in Codex?

Run `npx skills add HoangNguyen0403/agent-skills-standard --skill nextjs-upgrade -a codex`. Or copy the skill folder (skills/nextjs/nextjs-upgrade in HoangNguyen0403/agent-skills-standard) into .agents/skills/nextjs-upgrade in your project. Codex loads it when a task matches its description.

Can I use Nextjs Upgrade in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add HoangNguyen0403/agent-skills-standard --skill nextjs-upgrade -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/nextjs-upgrade, .gemini/skills/nextjs-upgrade, .github/skills/nextjs-upgrade and .opencode/skills/nextjs-upgrade in your project.

What does Nextjs Upgrade need to run?

Going by SKILL.md and its folder, Nextjs Upgrade needs the command-line tools its instructions call (npx). Our summary lists: Node.js.

Does Nextjs Upgrade access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Nextjs Upgrade safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Nextjs Upgrade use?

Nextjs Upgrade is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Nextjs Upgrade use?

About 610 tokens (SKILL.md is roughly 2.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 50 tokens, read only when the agent opens those files.

What are the alternatives to Nextjs Upgrade?

Skills that share tags, products or a category with Nextjs Upgrade: Next Cache Components Adoption (vercel/next.js, 143k stars), Chakra UI v2 to v3 Migration (chakra-ui/chakra-ui, 41k stars), Next Best Practices (vercel-labs/openreview, 1.7k stars) and Nuqs (trycompai/crm, 11k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Nextjs Upgrade?

HoangNguyen0403 (a GitHub user) maintains it in HoangNguyen0403/agent-skills-standard, which has 572 GitHub stars. The repository holds 211 skills in this directory. The repository was last updated on October 9, 2026.

Source: HoangNguyen0403/agent-skills-standard on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.