CtrlK
BlogDocsLog inGet started
Tessl Logo

formatter-development

Use this skill whenever implementing or debugging Biome formatter behavior, IR composition, node rules, layout selection, source-comment handling, verbatim formatting, idempotency, internal specs, or Prettier comparison. Do not use it for generic snapshot commands or parser changes.

69

Quality

84%

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

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

A high-quality, expert-level skill body: dense non-generic guidance with exact API names, commands, and file paths, a clearly sequenced workflow with validation checkpoints, a feedback loop for suppression-check failures, and a review checklist. The main weaknesses are mild redundancy across 'Printing Discipline', 'Token Rules', and 'Review Checklist', a few test steps given without their commands, and no bundled detail files to offload the dense rule text.

Suggestions

Deduplicate the token-handling rules: 'Token Rules' restates the format_removed/format_replaced bullets already covered in 'Printing Discipline' — merge them into one section and let the Review Checklist reference it rather than restate it.

Give the executable commands for the workflow's test steps (e.g., the actual cargo/just invocation for 'Run focused formatter tests' and how to run 'quick_test'), so every step is copy-paste runnable like the prettier-compare examples.

Consider moving the long rule lists (e.g., 'Printing Discipline' or 'Node Rules') into a bundled reference file and keeping a short overview in SKILL.md, improving progressive disclosure and trimming the inline token count.

DimensionReasoningScore

Conciseness

The body is dense and prescriptive with no filler or explanations of concepts Claude already knows (e.g., "Formatter output is a structured rewrite of the source tree, not a fresh pretty-printer" assumes competence). It falls short of anchor 5 because the format_removed/format_replaced rules appear in both 'Printing Discipline' and again in 'Token Rules', and the 'Review Checklist' largely restates earlier bullets — minor redundancy that could be trimmed.

4 / 5

Actionability

Highly concrete guidance: exact API calls ("format_removed(&token)", "f.context().comments().is_suppressed(node.syntax())", "mark_suppression_checked(node.syntax())"), copy-paste shell commands ("bun packages/prettier-compare/bin/prettier-compare.js --rebuild -l js 'const value={a:1}'", "just f", "just l"), and named repo files. Below anchor 5 only because a few workflow steps ('Run focused formatter tests', 'quick_test') are named without the actual commands to run them.

4 / 5

Workflow Clarity

Clear six-step sequenced Workflow, a 'Generation and Verification' section with explicit validation checkpoints ('review snapshots before accepting them', reformat-converges check), a concrete error-recovery feedback loop (suppression assertion reports a node → call mark_suppression_checked), and a full Review Checklist — matching anchor 5's sequence plus validation, feedback loops, and checklist.

5 / 5

Progressive Disclosure

Well-organized sections with a clearly signaled, one-level-deep 'References' list of canonical repo files (CONTRIBUTING.md guides, spec.rs, prettier-compare README); no nested references. Below anchor 5 because no bundle files exist, so ~120 lines of dense rules are all inlined in SKILL.md and the reference paths are repo-relative rather than bundled detail files — a minor organization gap.

4 / 5

Total

17

/

20

Passed

Description

87%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 both what the skill covers and when to use it with explicit trigger phrases, delimits a clear niche with an explicit exclusion clause, and names many concrete capability areas. Its only weakness is that capabilities are listed as topic nouns with a few natural synonyms missing rather than as fully verb-led actions.

DimensionReasoningScore

Specificity

Names the domain ("implementing or debugging Biome formatter behavior") and enumerates many concrete capability areas ("IR composition, node rules, layout selection, source-comment handling, verbatim formatting, idempotency, internal specs, or Prettier comparison"), giving several specific actions with only minor coverage gaps. It falls just below anchor 5 because the capabilities are listed mostly as topic nouns rather than the fully concrete verb-action pairs of the top example, and clearly above anchor 3's '1-2 concrete actions'.

4 / 5

Completeness

Explicitly answers 'what' (implementing or debugging the listed Biome formatter areas) and 'when' ("Use this skill whenever implementing or debugging...") with concrete trigger phrases, and adds an explicit exclusion clause ("Do not use it for generic snapshot commands or parser changes"). This matches anchor 5's clear and explicit what-and-when with concrete triggers.

5 / 5

Trigger Term Quality

Good keyword coverage with natural phrases a Biome contributor would say — "Biome formatter", "node rules", "verbatim formatting", "idempotency", "Prettier comparison", plus the negative triggers "generic snapshot commands or parser changes". A few natural synonyms are missing (e.g., plain "formatting" output, "snapshot tests", file extensions), keeping it below anchor 5's comprehensive synonym coverage, but well above anchor 3's sparse keywords.

4 / 5

Distinctiveness Conflict Risk

"Biome formatter" is a clear niche with distinct, domain-specific triggers, and the explicit exclusions ("Do not use it for generic snapshot commands or parser changes") further reduce mis-triggering against adjacent skills. Minimal conflict risk, matching anchor 5.

5 / 5

Total

18

/

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.