CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

lint-rule-development

Use this skill when creating or modifying Biome lint rules or assists, including analyzer queries, semantic bindings, rule state, code actions, fix safety, options, registration, and end-user rule rustdoc. Also load diagnostics-development for substantial message/advice design and testing-codegen for fixture or snapshot mechanics.

75

Quality

94%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

93%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.

Excellent body content: dense, repo-specific, and fully actionable for a coding agent, with well-signaled delegation to the analyzer guide and sibling skills for detail. The single notable gap is the absence of an explicit snapshot/test failure feedback loop in the workflow, though this is partially covered by the testing-codegen reference.

DimensionReasoningScore

Conciseness

The body is lean, imperative, and assumes Claude's competence throughout — e.g. '`Ast<Node>` for syntax-local checks', 'Set `FixKind::Safe` only when no reachable input changes behavior', 'Prefer ranges, syntax nodes, tokens, and compact enums in `State`'. Every line is Biome-specific policy or command; nothing explains concepts Claude already knows, matching anchor 5 ('every token earns its place').

5 / 5

Actionability

Fully executable guidance: copy-paste scaffolding and test commands ('just new-js-lintrule useMyRule', 'just test-lintrule useMyRule', 'just gen-rules', 'just gen-configuration', 'just f'/'just l') plus concrete APIs and artifacts ('declare_lint_rule!', 'type Options', 'options.json', 'visited_kinds', 'FixKind::Safe'). This matches anchor 5 ('copy-paste ready commands; specific examples cover the common cases').

5 / 5

Workflow Clarity

A clear 6-step numbered sequence with explicit validation checkpoints ('then inspect snapshots', 'Run required analyzer codegen and the narrowest tests', 'Run `just f` and `just l` as required by `AGENTS.md`') and a final Review Checklist. It falls short of anchor 5 only because there is no explicit error-recovery feedback loop (e.g. what to do when a snapshot or test disagrees), which is instead delegated to 'testing-codegen'; anchor 4's 'clear sequence with most checkpoints present; minor validation gaps' is the closest fit.

4 / 5

Progressive Disclosure

No bundle files exist; the body stays a lean overview and defers detail through clearly signaled, one-level-deep references: 'Load `diagnostics-development` for message structure...', 'Follow the analyzer guide sections **Rule Options**, **Merge**, and **Documenting Options**', and the terminal References section listing repo paths. Nothing that belongs elsewhere is inlined, matching anchor 5 ('clear overview with well-signaled one-level-deep references').

5 / 5

Total

19

/

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: it explicitly states what the skill covers (a comprehensive enumeration of rule/assist development areas) and when to use it, in third person, without padding. The only gap is a few natural trigger synonyms (e.g. suppressions, autofix/nursery) that would broaden keyword coverage.

DimensionReasoningScore

Specificity

The description enumerates comprehensive concrete capabilities: 'creating or modifying Biome lint rules or assists, including analyzer queries, semantic bindings, rule state, code actions, fix safety, options, registration, and end-user rule rustdoc'. This spans the full rule-development lifecycle, matching the anchor-5 pattern of multiple specific concrete actions with comprehensive coverage rather than anchor 4's 'several specific actions; minor gaps'.

5 / 5

Completeness

Both questions are answered explicitly: 'what' via the enumerated capability areas and 'when' via the concrete trigger 'Use this skill when creating or modifying Biome lint rules or assists', plus escalation triggers ('Also load diagnostics-development for substantial message/advice design'). It clearly matches anchor 5; it is not anchor 4 because the 'when' is explicit and specific rather than generic.

5 / 5

Trigger Term Quality

Natural domain keywords are well covered — 'lint rules', 'assists', 'code actions', 'fix safety', 'rustdoc', 'fixture or snapshot mechanics' — but a few terms a user would plausibly say are missing (e.g. 'suppression', 'autofix'/'safe fix', 'nursery'/'changeset'). This matches anchor 4 ('good keyword coverage; a few natural terms missing') and not anchor 5, which requires synonyms and variations.

4 / 5

Distinctiveness Conflict Risk

The description is tightly anchored to a niche ('Biome lint rules or assists') with distinct triggers, and it explicitly partitions concerns with sibling skills (diagnostics-development for message/advice design, testing-codegen for fixtures/snapshots). This is a clear niche with minimal conflict risk, matching anchor 5.

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

.agents/skills/lint-rule-development/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.