CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

biome-complete

Complete Biome toolchain guidance for real repository workflows. Use when users ask to configure biome.json, run lint or format commands, migrate from ESLint or Prettier, tune rule severity, fix formatter drift, or replace mixed ESLint+Prettier pipelines with Biome-only workflows.

72

Quality

91%

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

85%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 actionability, workflow sequencing with real validation checkpoints, and a well-structured one-level-deep reference bundle. The main cost is token duplication: commands appear in both the workflow and Quick Commands sections, and the anti-pattern catalogue is longer and more ritualistic than its content requires.

Suggestions

Merge Quick Commands into the Deterministic Workflow (or reduce it to a single command table) — init, check, check --write, format --write, and --error-on-warnings currently each appear twice with overlapping expected-result notes.

Consolidate the two suppression anti-patterns ("blanket-ignore diagnostics" and "add a suppression without a reason") into one block, and drop or shorten the Consequence lines — WHY/BAD/GOOD already carry the lesson in every block.

Trim the anti-pattern count from nine to the six distinct failure modes; blocks like "never re-enable every rule group at once" and "never declare success without re-running the check" restate guidance already given in the Error Recovery and Verify steps.

DimensionReasoningScore

Conciseness

The body avoids explaining concepts Claude already knows and stays dense and actionable, but it is not tight: the Quick Commands section duplicates the commands already embedded in the Deterministic Workflow (init, check, check --write, format --write, --error-on-warnings all appear twice), and nine anti-pattern blocks each carry a WHY/BAD/GOOD/Consequence quad with overlapping pairs (e.g., the two suppression rules restating the same principle). This fits the 3 anchor ("mostly efficient but... could be tightened") better than 4 ("minor instances"), because the duplication is systematic rather than incidental.

3 / 5

Actionability

Fully executable, copy-paste-ready commands throughout ("bunx @biomejs/biome init", "bunx @biomejs/biome check . --write", "bunx @biomejs/biome format . --write", "--error-on-warnings"), each paired with an expected result, plus a concrete error-recovery procedure (disable rule groups, re-enable one at a time). Matches the 5 anchor; common cases are covered with specific commands, not hints.

5 / 5

Workflow Clarity

The Deterministic Workflow is a clearly numbered 6-step sequence with explicit **Verify:** checkpoints at steps 3, 4, and 6 (confirm diagnostics printed, confirm reduced error count, confirm exit code 0), plus an Error Recovery feedback loop for post-migration failures. The batch-rewrite operation (--write) is properly validated by re-running the check, so no cap applies; this matches the 5 anchor's explicit-validation-with-recovery-loop pattern.

5 / 5

Progressive Disclosure

SKILL.md is a genuine overview: deep detail (config schema, rule categories, formatter options, migration steps) is split into four real one-level-deep reference files, surfaced through a table with Topic / Reference / When-to-Use columns, and the body also links the migration reference inline exactly where a failure step points to it. All four referenced paths exist in the bundle; navigation is easy and nothing that belongs in a reference is inlined.

5 / 5

Total

18

/

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 with concrete, comprehensive capability enumeration and an explicit, trigger-rich 'Use when' clause in third-person voice. The only weakness is modest synonym coverage for how users phrase Biome adoption requests.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete actions — "configure biome.json, run lint or format commands, migrate from ESLint or Prettier, tune rule severity, fix formatter drift, or replace mixed ESLint+Prettier pipelines" — covering config, lint/format, migration, tuning, and pipeline replacement comprehensively, matching the 5 anchor. Not 4, because there are no meaningful gaps in action coverage; the only soft phrase ("guidance for real repository workflows") is immediately grounded by the concrete verb list.

5 / 5

Completeness

Explicitly answers both questions: the "what" ("Complete Biome toolchain guidance" with enumerated capabilities) and a fully explicit "when" ("Use when users ask to configure biome.json, run lint or format commands, migrate from ESLint or Prettier..."). This mirrors the 5 anchor's example structure exactly; anchor 4 would require a less explicit or less specific 'when' clause.

5 / 5

Trigger Term Quality

Good keyword coverage with natural phrases users would say ("migrate from ESLint", "fix formatter drift", "configure biome.json"). Scored 4 rather than 5 because common variations like "set up Biome", "switch to Biome", or "replace Prettier" are absent; anchor 5 requires synonyms and comprehensive natural-term coverage.

4 / 5

Distinctiveness Conflict Risk

A clear niche (Biome-only toolchain) with distinct triggers naming the tool and its config file; it would not plausibly fire for an ESLint-only or Prettier-only request since those terms appear only in migration context. Only trivial overlap via the generic phrase "run lint or format commands".

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

pantheon-org/tekhne

Path

skills/development/biome-complete/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.