CtrlK
BlogDocsLog inGet started
Tessl Logo

diagnostics-development

Use this skill when designing or implementing Biome user-facing diagnostic presentation or APIs, including messages, advice, markup, details, code frames, categories, severity, and standalone `Diagnostic` types. Do not use for lint matching logic or code-action mutations.

77

Quality

96%

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

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.

This is a tightly written, decision-rule style skill body: every section gives project-specific constraints rather than generic explanations, and detail is delegated to a canonical external guide via clear one-level references. Validation and a review checklist close the loop. No material weaknesses found.

DimensionReasoningScore

Conciseness

The body is lean and directive throughout — e.g. 'Interpolate values directly in `markup!`; do not allocate with `format!` first', 'Do not edit generated diagnostic-category registries by hand'. It explains nothing Claude already knows and every token carries a project-specific decision rule. There is no padding to trim, so it fits the top anchor rather than anchor 4's 'minor instances of over-explanation'.

5 / 5

Actionability

For an instruction-only skill the guidance is fully concrete: named APIs ('Use `RuleDiagnostic` for lint and assist rules'), a need-to-mechanism mapping table (note/detail/diff/command/verbose advice), named files ('crates/biome_diagnostics/CONTRIBUTING.md', 'crates/biome_diagnostics/src/advice.rs'), and named skills to load ('lint-rule-development', 'testing-codegen'). Per the rubric's scoring note, absence of code is not penalized when the instruction guidance is this specific.

5 / 5

Workflow Clarity

The implied sequence is coherent — inspect existing diagnostics, choose the API, shape messages/advice, handle categories and severity, then validate — with an explicit Validation section ('Add the narrowest test or fixture that renders the diagnostic', 'Test conditional advice in every branch') and a Review Checklist as the final checkpoint. It is not anchor 4 because both a dedicated validation stage and a completion checklist are present, not merely 'most checkpoints'.

5 / 5

Progressive Disclosure

The body acts as an overview and decision guide that delegates deep detail to clearly signaled one-level references ('Use `crates/biome_diagnostics/CONTRIBUTING.md` as the canonical API and design guide', 'Existing derive examples: search for `#[derive(Diagnostic)]`'), and a References section lists exact paths. Nothing that belongs in a separate file is inlined, and no bundle files exist to restructure. It is not anchor 4 because there are no organization gaps to point to.

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: it states a concrete what, an explicit when, a full inventory of the domain's capability areas, and a disambiguating do-not-use clause. The only gap is a few missing natural synonyms ('error', 'warning') that would broaden trigger coverage.

DimensionReasoningScore

Specificity

The description lists multiple concrete capability areas — 'messages, advice, markup, details, code frames, categories, severity, and standalone `Diagnostic` types' — under the concrete actions 'designing or implementing Biome user-facing diagnostic presentation or APIs', giving comprehensive coverage of the domain. It does not fall to 4 because no meaningful capability area of diagnostic presentation is left unnamed.

5 / 5

Completeness

It explicitly answers 'what' ('designing or implementing Biome user-facing diagnostic presentation or APIs, including messages, advice, markup...') and 'when' ('Use this skill when...'), plus an explicit negative trigger ('Do not use for lint matching logic or code-action mutations'). Both are concrete and explicit, matching the top anchor exactly.

5 / 5

Trigger Term Quality

Good keyword coverage with natural terms a Biome contributor would say: 'diagnostic', 'messages', 'advice', 'markup', 'code frames', 'categories', 'severity', 'Diagnostic types'. Not 5 because common user-facing synonyms like 'error', 'warning', or 'error message' are absent, so a few natural phrasings could miss the trigger.

4 / 5

Distinctiveness Conflict Risk

Clear niche (Biome user-facing diagnostic presentation/APIs) with an explicit exclusion clause separating it from adjacent skills ('Do not use for lint matching logic or code-action mutations'), minimizing conflict risk. This is a distinct trigger surface, not merely 'minor overlap risk' as at anchor 4.

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