skill CX Codex

rspack-v2-upgrade — Claude Code skill: move Rspack 1.x to v2

Q: How do I install rspack-v2-upgrade in Claude?

Run `npx skills add rstackjs/agent-skills --skill rspack-v2-upgrade -a claude-code`. The skill lands in `~/.claude/skills/rspack-v2-upgrade/SKILL.md`.

Walks a Rspack 1.x project through the v2 upgrade: dependencies, config, build checks. Useful when a major bump is too fiddly to do by hand.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓

npx skills add rstackjs/agent-skills --skill rspack-v2-upgrade -a claude-code

Open on GitHub

What rspack-v2-upgrade does

The skill runs the upgrade as a sequence. It reads package.json to see which Rspack packages are in play, then locates the config file — commonly rspack.config.(ts|js|mjs|cjs). Your current setup gets compared against the official migration guide, and the skill lists which breaking changes actually apply: removed or renamed options, changed defaults, plugin API shifts.

Dependencies come next: @rspack/core, @rspack/cli, @rspack/dev-server, @rspack/plugin-react-refresh. Config and related code are edited to match the guide, deprecated options dropped. Then it validates — build, dev server, tests or type checks — and works through whatever warnings the new version surfaces.

The official migration guide is the single source of truth here, not the agent's guesses. Worth knowing: it covers Rspack core. If your config wires up custom plugins, check their docs separately, or some changes will slip past.

What it helps with

upgrade Rspack 1.x to v2 without missing breaking changes
find and remove renamed or dropped config options
bump @rspack/core, @rspack/cli and dev-server together
verify build and tests after a major version jump
triage warnings that appear on the new version

Example prompts for the agent

Upgrade this project from Rspack 1.x to v2 following the official migration guide
Compare my rspack.config.ts against the migration guide and list the breaking changes that apply
Bump the Rspack packages to v2 and run the build and tests

How to install rspack-v2-upgrade

1Skills CLI (Vercel)

npx skills add rstackjs/agent-skills --skill rspack-v2-upgrade -a claude-code

2Manually: put the files in place

~/.claude/skills/rspack-v2-upgrade/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/rspack-v2-upgrade/

1Skills CLI (Vercel)

npx skills add rstackjs/agent-skills --skill rspack-v2-upgrade -a codex

2Manually: put the files in place

.agents/skills/rspack-v2-upgrade/SKILL.md

For all projects use ~/.agents/skills/

1Skills CLI (Vercel)

npx skills add rstackjs/agent-skills --skill rspack-v2-upgrade -a cursor

2Manually: put the files in place

.cursor/skills/rspack-v2-upgrade/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install rstackjs/agent-skills rspack-v2-upgrade

2Manually: put the files in place

.github/skills/rspack-v2-upgrade/SKILL.md

1Skills CLI (Vercel)

npx skills add rstackjs/agent-skills --skill rspack-v2-upgrade -a gemini-cli

2Platform CLI

gemini skills install https://github.com/rstackjs/agent-skills --path skills/rspack-v2-upgrade

Manually: put the files in place

.devin/skills/rspack-v2-upgrade/SKILL.md

The legacy .windsurf/skills/ path still works

Skills CLI (Vercel)

npx skills add rstackjs/agent-skills --skill rspack-v2-upgrade -a opencode

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about rspack-v2-upgrade

How do I install rspack-v2-upgrade in Claude?

Run npx skills add rstackjs/agent-skills --skill rspack-v2-upgrade -a claude-code. The skill lands in ~/.claude/skills/rspack-v2-upgrade/SKILL.md.

What does rspack-v2-upgrade do?

It moves a project from Rspack 1.x to v2: finds the config, checks it against the official migration guide, updates packages and settings, then runs build and tests.

Where does the upgrade break down?

The official guide covers Rspack core. Custom plugins in your config need their own docs checked, otherwise part of the changes goes unnoticed.

Source text

SKILL.md · MIT

---
name: rspack-v2-upgrade
description: Use when upgrading a Rspack 1.x project to v2, including dependency and configuration updates.
---

# Rspack 1.x to v2 upgrade

## Workflow

1. **Confirm current setup**
   - Read `package.json` to identify Rspack packages in use.
   - Locate the Rspack config file (commonly `rspack.config.(ts|js|mjs|cjs)`).

2. **Open the official migration guide**
   - Use the official guide as the single source of truth:
     - https://rspack.rs/guide/migration/rspack_1.x

3. **Plan required changes**
   - Compare the current project config with the migration guide.
   - List breaking changes that apply to the project’s current config and plugins.
   - Note any removed or renamed options, defaults, or plugin APIs.

4. **Update dependencies**
   - Upgrade Rspack packages to v2: `@rspack/core`, `@rspack/cli`, `@rspack/dev-server`, `@rspack/plugin-react-refresh`.

5. **Apply migration changes**
   - Update the Rspack config and related code according to the official guide.
   - Remove deprecated or unsupported options.

6. **Validate**
   - Run build and dev commands.
   - Run project tests or type checks.
   - Fix any warnings or errors surfaced by the new version.

Similar skills

Everything for Frontend and UI →

rspeedy-bundle-size lynx-community A skill that breaks down what makes a rspeedy/ReactLynx .lynx.bundle heavy and tells you which lever to pull first. CX Codex +1 458installs parcel-bundler Mindrally A skill that gives the agent a working set of Parcel conventions: entry points, TypeScript, CSS modules, caching and production builds. Useful when the project has no bundler config. CX Codex +1 633installs upgrade-browser-sdk-v7 datadog-labs Walks a project through the Datadog Browser SDK jump from v6 to v7: stale options, CDN paths, changed APIs. Useful when the upgrade breaks init. CX Codex +1 459installs tsdown-migrate rolldown A skill that walks a TypeScript library from tsup to tsdown: option mappings, config transformation rules, default differences and replacements for removed options. CX Codex +1 388installs migrate toss Reads your lodash code and shows how to swap each function for es-toolkit or es-toolkit/compat. Handy when the bundle needs to shrink. CX Codex +1 313installs dotnet-upgrade official github Plan a .NET upgrade by reviewing project dependencies, choosing a migration order and preparing post-upgrade checks. 11,475installs

From the same set9

rsbuild-best-practices Provides rules for configuring, reviewing, and troubleshooting Rsbuild applications. Helps agents inspect builds, handle assets, and profile performance. CX Codex +1 2,700installs rstest-best-practices Rules for setting up and writing Rstest tests: environments, mocks, snapshots, coverage and CI. Useful when a package moves to Rstest or its tests have drifted apart. CX Codex +1 1,400installs rslib-best-practices Provides guidelines for building JavaScript and TypeScript libraries with Rslib. Useful when configuring outputs, declaration files, and dependency bundling. CX Codex +1 1,000installs rspress-best-practices A skill that gives the agent rules for Rspress v2 sites: config, navigation, MDX, assets, search and deployment. Useful once the docs exist and the agent edits them. CX Codex +1 538installs rspress-description-generator A skill that fills in the description frontmatter field on Rspress pages that lack one. Useful when the docs site has grown and meta descriptions are missing in places. CX Codex +1 498installs rsbuild-v2-upgrade Walks a Rsbuild 1.x project through the v2 migration: dependencies, config, breaking options. Useful when a major bump would otherwise eat an evening. CX Codex +1 476installs migrate-to-rstest Migrates Jest, Vitest, or Playwright Test suites to Rstest while keeping test discovery, assertions, mocks, snapshots, and coverage intact. For moving a runner without rewriting scenarios. CX Codex +1 420installs rspress-custom-theme A skill that walks your agent through Rspress v2 theme changes, from CSS variables up to replacing built-in components. CX Codex +1 408installs