CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

biome-linting

Analyze, fix, and validate Biome linting workflows. Use when JavaScript or TypeScript projects need Biome commands, diagnostics, safe fixes, or CI lint gates.

Quality

76%

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

Fix and improve this skill with Tessl

tessl review fix ./Skills/agent-ops/biome-linting/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

56%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 well-structured, lean runbook skeleton with a clear sequenced workflow and genuine fail-fast validation checkpoints. Its core weakness is actionability — it reads as a generic process contract with zero executable Biome commands, named config files, or concrete diagnostic surfaces — plus a progressive-disclosure pointer that does not match the actual bundle.

Suggestions

Add the concrete commands for each remediation mode, e.g. `npx biome check .` for diagnosis, `npx biome check --fix --safe .` for safe fixes, and `npx biome check --fix --unsafe .` gated on explicit approval, so the Workflow steps map to real invocations.

Name the actual input surfaces in Inputs and the "Inspect 2-3 focused surfaces" step — e.g. `biome.json`/`biome.jsonc`, the `lint`/`check` scripts in `package.json`, and the CI workflow file that runs the lint gate.

Fix the Progressive Disclosure section to point at files that exist in the bundle (e.g. `references/contract.yaml`), or move the archived context under `Infrastructure/references/deferred-skill-context/agent-ops-biome-linting/` so the referenced path resolves.

DimensionReasoningScore

Conciseness

The body is lean and sectioned with no explanations of concepts Claude already knows (it never explains what Biome or linting is). Anchor 4 rather than 5 because of minor trim opportunities: the "Avoid" and "Anti-Patterns" sections overlap substantially, and the bare-noun Inputs/Outputs lists plus "Philosophy" platitudes ("Keep the workflow evidence-first and bounded to the requested scope") earn their place only loosely.

4 / 5

Actionability

No concrete command appears anywhere — no `biome check`, no `biome check --fix --safe`, no named config file, and "Inspect 2-3 focused surfaces" never says which surfaces. This matches anchor 2 ("Minimal concrete guidance; high-level hints but missing the specific steps to execute") rather than anchor 1, because the Workflow and Validation sections do instruct sequencing and fail-fast behavior rather than merely describing.

2 / 5

Workflow Clarity

The Workflow section gives a clear five-step sequence with explicit validation checkpoints ("Stop at the first failed gate or blocker", "Rerun the relevant validation after fixes before claiming completion") and a fix-then-rerun feedback loop, echoed by the Validation section — so the destructive/batch cap at 3 does not apply. Anchor 4 rather than 5 because the steps are abstract ("Take the smallest action that advances the confirmed goal") without the concrete commands the anchor-5 example includes.

4 / 5

Progressive Disclosure

Sections are well organized and the body is short, but scored against the actual bundle: the only reference pointer ("Archived source, scripts, assets, and long-form references live under `Infrastructure/references/deferred-skill-context/agent-ops-biome-linting/`") does not resolve to any file in the bundle, while the real bundle files (`references/contract.yaml`, `references/evals.yaml`, `references/task-profile.json`) are never mentioned. This fits anchor 3 ("references present but not clearly signaled" / organization gaps) better than anchor 4, since the sole pointer is dangling relative to the actual file listing.

3 / 5

Total

13

/

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 in third-person voice with an explicit "Use when..." trigger clause and a clearly named, distinctive niche. The only weakness is minor gaps in action coverage within the Biome domain (formatting, rule configuration) and a few missing natural trigger synonyms.

DimensionReasoningScore

Specificity

The description lists several concrete actions ("Analyze, fix, and validate") tied to a named domain, with objects like "Biome commands, diagnostics, safe fixes, or CI lint gates". It sits at anchor 4 rather than 5 because coverage within the Biome niche has minor gaps — no mention of formatting, config setup, or rule tuning, which are core parts of Biome usage.

4 / 5

Completeness

It explicitly answers both parts: the "what" ("Analyze, fix, and validate Biome linting workflows") and the "when" via a concrete "Use when JavaScript or TypeScript projects need Biome commands, diagnostics, safe fixes, or CI lint gates" trigger clause. This matches the anchor-5 pattern of a clear what plus an explicit when with concrete trigger phrases.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "Biome" (repeated), "lint", "diagnostics", "CI lint gates", "safe fixes", "JavaScript or TypeScript projects" — terms a user with a Biome problem would plausibly say. Not anchor 5 because common variations like "linter", "lint errors", or "formatting" are missing, so a few natural terms users might say are absent.

4 / 5

Distinctiveness Conflict Risk

"Biome" is a specific named tool, making this a clear niche with distinct triggers; the description is unlikely to capture generic linting or ESLint requests because every capability is scoped to Biome. Anti-drift check against anchor 4 ("minor overlap risk with closely related skills") finds no meaningful overlap, since the tool name gates every trigger.

5 / 5

Total

18

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

jscraik/Agent-Skills

Path

Skills/agent-ops/biome-linting/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.