upgrade-oxc — Claude Code skill: update oxc and fix breaking changes
upgrade-oxc updates oxc dependencies in Rolldown: npm packages and Rust crates, runs codegen, and fixes breaking changes in code.
MIT ★ 14,038 updated 2026-10-29
npx skills add rolldown/rolldown --skill upgrade-oxc -a claude-codeWhat upgrade-oxc does
The skill bumps versions of @oxc-project/types, oxc_allocator, oxc_resolver, and other oxc packages, pulls changes via cargo update and pnpm install, runs just update-generated-code to regenerate code, and executes tests. If cargo check or just roll fail, it fixes renamed types, changed method signatures, and removed APIs. At the end, it reports old and new versions, the number of changed files, and a list of fixed breaking changes.
Requires Rust, Node.js, pnpm, and just — a make-based task runner. Without just in PATH, commands will not execute. The skill runs each step sequentially: steps depend on one another, and parallel execution will break the build.
What it helps with
- update oxc dependencies to the latest version
- fix breaking changes after oxc upgrade
- run codegen and rebuild the project
- verify compatibility with new oxc APIs
Example prompts for the agent
- Update oxc to the latest version and fix any breaks
- Bump oxc package versions in Cargo.toml and pnpm-workspace.yaml
- Run the full oxc upgrade with all steps
How to install upgrade-oxc
1Skills CLI (Vercel)
npx skills add rolldown/rolldown --skill upgrade-oxc -a claude-code2Manually: put the files in place
~/.claude/skills/upgrade-oxc/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/upgrade-oxc/
1Skills CLI (Vercel)
npx skills add rolldown/rolldown --skill upgrade-oxc -a codex2Manually: put the files in place
.agents/skills/upgrade-oxc/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add rolldown/rolldown --skill upgrade-oxc -a cursor2Manually: put the files in place
.cursor/skills/upgrade-oxc/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install rolldown/rolldown .claude/skills/upgrade-oxc2Manually: put the files in place
.github/skills/upgrade-oxc/SKILL.md1Skills CLI (Vercel)
npx skills add rolldown/rolldown --skill upgrade-oxc -a gemini-cli2Platform CLI
gemini skills install https://github.com/rolldown/rolldown --path .claude/skills/upgrade-oxcManually: put the files in place
.devin/skills/upgrade-oxc/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add rolldown/rolldown --skill upgrade-oxc -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about upgrade-oxc
How do I install upgrade-oxc in Claude Code?
Run npx skills add rolldown/rolldown --skill upgrade-oxc -a claude-code, the skill will be placed in ~/.claude/skills/upgrade-oxc/SKILL.md.
What does upgrade-oxc do?
It updates oxc npm packages and Rust crates, runs codegen, fixes breaking changes after the update, and runs tests. At the end, it reports versions, the number of changed files, and a list of fixed breaking changes.
What does upgrade-oxc require to work?
Rust, Node.js, pnpm, and just — a task runner. Without just, commands will not execute. The skill only works in the Rolldown repository.
Source text
SKILL.md · MIT
--- name: upgrade-oxc description: 'Upgrade oxc, run codegen, and fix any breaking changes.' --- # Upgrade OXC CRITICAL: Run each step sequentially ONE AT A TIME. Wait for each command to FULLY COMPLETE before proceeding to the next step. DO NOT run multiple commands in parallel - they have dependencies on each other. ## Steps 1. `git checkout main && git pull origin main` 2. `just setup` 3. `npm view @oxc-project/types version` - note the version 4. Edit `pnpm-workspace.yaml`: update `@oxc-project/runtime`, `@oxc-project/types`, `oxc-minify`, `oxc-parser`, `oxc-transform` to the version from step 3 (use `=x.y.z` format) 5. `cargo search oxc_allocator --limit 1` - note the version 6. `cargo search oxc_resolver --limit 1` - note the version 7. Edit `Cargo.toml`: update `oxc`, `oxc_allocator`, `oxc_ast`, `oxc_ecmascript`, `oxc_minify_napi`, `oxc_parser_napi`, `oxc_transform_napi`, `oxc_traverse` to version from step 5; update `oxc_resolver`, `oxc_resolver_napi` to version from step 6 8. `cargo update oxc oxc_allocator oxc_ast oxc_ecmascript oxc_minify_napi oxc_parser_napi oxc_transform_napi oxc_traverse oxc_resolver oxc_resolver_napi oxc_sourcemap oxc_index` 9. `pnpm install` - install updated npm packages 10. `cargo check` - if there are errors, fix all breaking changes before proceeding. Common breaking changes include renamed types, changed method signatures, or removed APIs. Study the error messages carefully and update the code accordingly. 11. `just update-generated-code` 12. `just test-update` 13. `just ued` 14. `just roll` - run the full build, lint, and test suite. Fix any remaining breaking changes or test failures before proceeding. 15. `git status --short && git diff --stat` - verify expected files changed 16. Summarize the upgrade by reporting: (a) the old and new versions, (b) number of files changed, (c) any breaking changes that were fixed, and (d) notable changes in the diff
© rolldown · MIT · rolldown/rolldown