Guide · Agent skill
How to use the Bump Biome Version agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
The bumping-biome skill is an agent skill that teaches an AI coding agent how to update the Biome package (for example @biomejs/biome) across a pnpm workspace, align its config files and run the project's lint checks. This guide explains what the skill does, how to install it, how to trigger it with natural requests and what to review before accepting its changes. It is written for readers who have never used agent skills before.
Bump Biome Versionprisma/orm · Apache-2.0 Download the skill Quick start
- 1Install the skill. Download the ZIP from this page and unzip it into ~/.claude/skills/ or a project's .claude/skills/ folder. Alternatively, upload it in the Claude apps under Settings → Capabilities → Skills.
- 2Confirm the requirements. Check that your repository uses pnpm and Biome (@biomejs/biome), and that it defines the scripts pnpm -w lint:fix and pnpm -w lint:fix:unsafe.
- 3Ask for the update. Make a plain request such as 'Update Biome to the latest version'. Include a specific version number if you need one.
- 4Let the agent install and align configs. The agent runs the pnpm install command, renames leftover biome.json files to biome.jsonc and updates the $schema version in each config.
- 5Run the lint-fix step. The agent runs pnpm -w lint:fix and reports any issues or regressions it finds.
- 6Decide on unsafe fixes. If remaining unsafe fixes are found, the agent offers pnpm -w lint:fix:unsafe. Accept only if you are comfortable with possible behaviour changes.
- 7Review the Git diff. Inspect all changes in Git, run your tests and commit only when the upgrade looks correct.
What the bumping-biome skill makes the agent do
Biome is a tool that checks and formats code. When this skill is installed, the agent follows a fixed routine whenever Biome needs updating. It installs the new Biome version with pnpm, using the latest version unless you name a specific one.
After the install, the agent renames any leftover biome.json files to biome.jsonc, updates the version number in each config's $schema reference, and runs the project's lint-fix script. It then reports any remaining problems and proposes fixes. The riskier unsafe-fix command only runs if you agree to it.
- Installs the Biome package across the workspace with pnpm
- Renames leftover biome.json files to biome.jsonc
- Updates the $schema version in every biome.jsonc
- Runs pnpm -w lint:fix and reports remaining issues
- Offers pnpm -w lint:fix:unsafe and waits for your approval
Install the bumping-biome skill
The skill is distributed as a ZIP file from the skill's page in this directory. Download the ZIP and unzip it into one of two places. For a personal setup, put it in ~/.claude/skills/. For a single project, put it in the project's .claude/skills/ folder so that everyone working in that repository gets it.
If you use the Claude apps instead, open Settings, go to Capabilities, and upload the skill under Skills. The skill's only file is SKILL.md.
- Personal install: unzip into ~/.claude/skills/
- Project install: unzip into the project's .claude/skills/
- Claude apps: Settings → Capabilities → Skills, then upload the skill
Check the requirements before you start
The skill only works in a specific setup. Your repository needs pnpm, Biome (@biomejs/biome) already used in the code, and two repository scripts: pnpm -w lint:fix and pnpm -w lint:fix:unsafe. Without these scripts the later steps will fail.
The commands and file names are specific to this workflow. If your project does not use pnpm or Biome, the skill is not the right tool.
- pnpm installed and a pnpm workspace in the repository
- Biome (@biomejs/biome) used in the repository
- Repository scripts pnpm -w lint:fix and pnpm -w lint:fix:unsafe
Trigger the skill with a natural request
You do not need a special command. Ask the agent in plain language to update Biome. The skill is also meant to run implicitly after broad upgrade commands that do not name packages, such as pnpm up, pnpm update or pnpm upgrade.
If you want a particular version, include it in your request. If you do not, the agent uses latest.
- "Update Biome to the latest version across the workspace."
- "Bump @biomejs/biome to 2.0.0 and fix the config files."
- "I ran pnpm up. Check whether Biome needs bumping too."
Review the changes and handle remaining issues
Because the lint-fix step changes code and the unsafe-fix step can alter behaviour, review the diff in Git before committing. The skill itself notes that version changes are visible in Git, so the diff is also where you confirm the new Biome version.
If issues remain after the safe fixes, the agent will suggest fixes and present a plan. You decide which steps to accept.
- Read the Git diff for package and config changes
- Decline the unsafe-fix step if you want to fix issues by hand
- Run your own tests after the upgrade
pnpm up -D -w -r @biomejs/biome@<version>What people use it for
- Updating Biome in a Prisma-style pnpm monorepo after a release
- Bumping Biome to a specific version that a team has agreed on
- Re-aligning biome.jsonc schema references after a broad pnpm up
- Getting a short report of lint regressions after an upgrade
Frequently asked questions
How do I install the bumping-biome skill?
Download the ZIP from this skill's page and unzip it into ~/.claude/skills/ for personal use or into a project's .claude/skills/ folder for a shared setup. In the Claude apps, you can instead upload it under Settings → Capabilities → Skills.
What does the bumping-biome skill require?
It requires pnpm, Biome (@biomejs/biome) used in the repository, and the repository scripts pnpm -w lint:fix and pnpm -w lint:fix:unsafe. It runs scripts and uses the network, so it is best used in a project you control.
Is the bumping-biome skill free?
This page does not state a price or licence terms for the skill itself. The source repository is listed under the Apache-2.0 licence, so check that licence for the terms of use.
Does the skill update packages other than Biome?
No. It only handles the Biome package and does not check other dependencies. Use a general dependency updater for the rest.
Can I choose which Biome version gets installed?
Yes. Name the version in your request, for example 'bump Biome to 2.0.0'. If you do not give a version, the skill uses latest.
Why does the agent ask before running lint:fix:unsafe?
The unsafe-fix command can change code behaviour, not just style. The skill only runs it after you agree, and you should review the resulting diff before committing.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Use this skill if you maintain a pnpm workspace that uses Biome, such as a Prisma-style monorepo, and want a repeatable upgrade routine. Pick something else if your project does not use pnpm or Biome, or if you need a general dependency updater that covers more than Biome.
Download the skill