Use this skill when promoting one or more Biome lint rules from nursery to stable groups, including promotion plans from GitHub issues, metadata changes, rule renames, generated configuration, and promotion snapshots.
77
97%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Low
Low-risk findings worth noting
Use the batch promotion task instead of invoking just move-rule repeatedly.
crates/biome_*_analyze/src/lint/nursery/ directory./tmp/biome-rule-promotions.json.The top-level object maps each current lower-camel-case rule name to its final stable metadata:
{
"noCurrentRule": {
"group": "correctness",
"recommended": true,
"severity": "error",
"newName": "noRenamedRule"
},
"useAnotherRule": {
"group": "style",
"recommended": false
}
}Fields:
group is required and must be a11y, complexity, correctness, performance, security, style, or suspicious.recommended is optional. Include it when the requirements specify the final recommendation status; both true and false are meaningful.severity is optional. Accepted values are info, warn, and error. Include it when the requirements specify a new final severity.newName is optional. Omit it when the rule keeps its current name.Use current names as object keys, even when newName is present. A rule implemented by multiple analyzers, such as matching JavaScript and HTML rules, needs only one entry.
Run the task once:
just promote-rules /tmp/biome-rule-promotions.jsonThe task validates the complete manifest before moving files. It updates declarations, diagnostic categories, fixture option files, rule-option modules, and the migration rename table as applicable. It does not regenerate derived files or snapshots.
Inspect the move before generation:
git status --short
git diff --statConfirm that every requested source file and fixture directory moved from nursery to its intended group. If a rule was renamed, search for stale occurrences of its old name and classify each occurrence before changing it; historical migration entries are expected to retain old names.
Load testing-codegen and run the required generators:
just gen-rules
just gen-configuration
just gen-migrateRun focused tests using each rule's final name. Review and accept pending snapshots individually according to testing-codegen; promotion snapshots must show the intended group and severity and must no longer contain the nursery notice.
Then run the analyzer crates affected by the manifest. If any rule was renamed, also run the biome_migrate tests and verify that configuration migration moves and renames the old key.
Run the repository-required checks:
just f
just lRun just lint-rules when rule documentation or suppression examples changed.
Rule promotion is user-facing and requires a minor changeset targeting next. Load changeset and describe the promoted groups, recommendation changes, severity changes, and renames that users need to know.
Delete the temporary manifest after the promotion is verified. Do not commit it unless the task explicitly requires a persistent promotion plan.
biomejs/biome
f447e08
Also appears in
since Oct 23, 2026
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.