Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add rolldown/rolldown --skill upgrade-oxc -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/upgrade-oxc/SKILL.md

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

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

Similar skills

All skills for DevOps and infrastructure →

Project sponsors

Companies that keep this analytics open