Content
85%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
Highly actionable and well-structured content with an exemplary validated workflow and clean progressive disclosure into four real reference files. The main drag on token efficiency is redundancy: the Quick Commands section duplicates four commands already given in the workflow, and anti-pattern Consequence lines repeat their WHY rationale.
Suggestions
Collapse the Quick Commands section so each command appears only once — either fold the two unique entries (format --write, single-file check) into the workflow/Quick Commands and drop the four duplicates, saving roughly 30 lines.
Drop or merge the "Consequence" line of each anti-pattern with its "WHY" line, since they restate the same rationale (e.g., "Competing rules create contradictory output" vs "Duplicate diagnostics and unstable CI outcomes").
Add the missing natural trigger phrases from the body's "When to Apply" ("set up Biome", "run Biome in CI") to the frontmatter description to round out trigger coverage.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean (no explanations of what Biome is or how linters work), but the "Quick Commands" section repeats `bunx @biomejs/biome init`, `check .`, `check . --write`, and `check . --error-on-warnings` verbatim from the "Deterministic Workflow", and the "Consequence" lines largely restate each anti-pattern's "WHY". This matches anchor 3 ("mostly efficient but… could be tightened") better than 4, where trimming would be only minor. | 3 / 5 |
Actionability | Every command is fully executable and copy-paste ready (`bunx @biomejs/biome init`, `check .`, `check . --write`, `format . --write`, single-file check, `--error-on-warnings` for CI), each paired with an expected result. Coverage of the common cases matches the top anchor. | 5 / 5 |
Workflow Clarity | The six-step "Deterministic Workflow" has a clear sequence with explicit **Verify** checkpoints at steps 3, 4, and 6, and an "Error Recovery" passage providing a feedback loop (disable rule groups, re-enable one at a time) for the repository-wide `--write` batch operation. This matches anchor 5: explicit validation plus error-recovery guidance. | 5 / 5 |
Progressive Disclosure | SKILL.md stays an overview and splits detail across four references that all exist, are one level deep (no nested references found in them), and are each annotated with their scope in the References section; one is also linked contextually inline in the workflow. This matches the top anchor for clear, well-signaled one-level-deep navigation. | 5 / 5 |
Total | 18 / 20 Passed |