CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

promote-lint-rules

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

Quality

97%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

100%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An exemplary instruction-only skill: lean, fully executable, and built around an explicit validation-rich workflow for a batch operation, with clean delegation to sibling skills for peripheral detail. No dimension shows meaningful weakness.

DimensionReasoningScore

Conciseness

Every line is project-specific instruction (the manifest JSON schema with field semantics, exact `just` commands, edge cases like "historical migration entries are expected to retain old names"). No explanations of concepts Claude already knows; nothing could be cut without losing actionable detail. Not 4 because there are no over-explanatory passages to trim.

5 / 5

Actionability

Fully executable throughout: a copy-paste-ready manifest example with a complete field spec, exact commands (`just promote-rules /tmp/biome-rule-promotions.json`, `just gen-rules`, `just gen-configuration`, `just gen-migrate`, `just f`, `just l`, `just lint-rules`), and a concrete inspection step (`git status --short`, `git diff --stat`). The common promotion case is covered end to end.

5 / 5

Workflow Clarity

A clearly sequenced four-phase workflow (Build Manifest → Apply Plan → Generate and Test → Release Entry and Cleanup) with abundant validation checkpoints for this batch operation: "Resolve incomplete or malformed requirements before editing", "The task validates the complete manifest before moving files", "Inspect the move before generation", "Confirm that every requested source file and fixture directory moved", and "Review and accept pending snapshots individually". The destructive/batch cap of 3 does not apply because verification is explicit at every phase.

5 / 5

Progressive Disclosure

No bundle files exist and none are needed at this size: the body is well-sectioned, self-contained, and appropriately delegates detail to explicitly named one-level-deep resources ("Load `testing-codegen` and run the required generators", "Load `changeset` and describe...") rather than inlining them. Navigation via the four section headers is unambiguous.

5 / 5

Total

20

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: explicit "Use this skill when" trigger, concrete enumerated capabilities, and a distinctive niche. The only minor gap is trigger-term breadth — a few natural synonyms (e.g., "move/graduate rules") would broaden matching.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions: "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" — comprehensive coverage of the skill's scope with no vague filler. Not 4 because the enumerated sub-tasks (metadata changes, renames, generated configuration, snapshots) leave no minor coverage gaps.

5 / 5

Completeness

Explicitly answers both questions: the what ("promoting one or more Biome lint rules from nursery to stable groups, including... metadata changes, rule renames, generated configuration, and promotion snapshots") and the when ("Use this skill when promoting..."). Both are concrete, matching the anchor's example structure.

5 / 5

Trigger Term Quality

Natural domain keywords are present ("Biome lint rules", "nursery", "stable groups", "rule renames", "promotion") that a contributor would genuinely say. Not 5 because common variations and synonyms are missing (e.g., "move rule", "graduate rule", or mention of the rules directory/contributor docs); not 3 because the terms are specific and natural rather than generic.

4 / 5

Distinctiveness Conflict Risk

"Promoting Biome lint rules from nursery to stable groups" carves out a clear niche with virtually no overlap risk with other skills — the terms are unique to this exact task. It cannot conflict with generic linting or code-review skills.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

biomejs/biome

Path

.claude/skills/promote-lint-rules/SKILL.md

Reviewed

Table of Contents

Is this your skill?

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.