Agent skill · software engineering · vercel
next-rspack
Maintain @next/rspack-core and @next/rspack-binding packages. Use when editing rspack/package.json, rspack/crates/binding/Cargo.toml, rspack/rust-toolchain.toml, or packages/next-rspack/package.json. Covers upgrading @rspack/core npm version, rspack_* crate versions, Rust toolchain version, building and linking for local testing, and NEXT_RSPACK environment variable usage. Does NOT apply to root rust-toolchain.toml (that's for Turbopack).
Why this skill is useful
Provides specific commands and procedures for upgrading and maintaining Rspack packages that the AI wouldn't reliably generate on its own.
What it needs
About 4k tokens when loaded. Last updated 2026-08-07. 141,663 stars on the source repository.
What this skill does
Next.js with Rspack When to Use Use this skill when you need to: Upgrade @rspack/core npm package version Upgrade rspack crate dependency versions Upgrade Rust version in rspack/rust-toolchain.toml (rspack directory only) Fix Rspack-related compilation issues Develop Rspack-specific features in Next.js ⚠️ Scope Limitation: This skill only applies to code and configuration under the rspack/ directory. The rust-toolchain.toml in the repository root is for Turbopack and is outside the scope of this skill. Architecture Overview Package Structure Dependency Graph Version Mapping Rules @rspack/core npm version rspack crate version Notes ------------------------ -------------------- ------------------------------------------------- 2.0.0-rc.0 0.100.0-rc.0 npm major.minor maps to crate 0.(major\50+minor) 1.3.x 0.53.x e.g., 1.3 → 0.53 1.2.x 0.52.x e.g., 1.2 → 0.52 Upgrade Process Step 1: Get Upstream Version Information Query https://github.com/web-infra-dev/rspack to obtain: Target @rspack/core npm version Corresponding rspack crate version Rust channel version from rust-toolchain.toml Step 2: Update npm Dependencies Edit rspack/package.json: Step 3: Update Cargo.toml Edit rspack/crates/binding/Cargo.toml, update all rspack crate versions: Step 4: Update Rust Toolchain Edit rspack/rust-toolchain.toml: Step 5: Verify Build Step 6: Link to packages/next-rspack rspack/ is an independent workspace not included in the root pnpm-workspace, manual linking is required: Or modify packages/next-rspack/package.json to use local path (for local testing only, do not commit): Important: After linking, run pnpm install in the root directory to update dependency relationships. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills vercel/next-rspack