Content
35%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill reads as a generic agent process template with 'Biome' inserted into the title and description. It lacks any concrete Biome-specific knowledge—no CLI commands, no configuration examples, no diagnostic patterns, no rule names, and no executable code. The workflow and constraints sections describe sound general practices but fail to teach Claude anything it doesn't already know about how to approach a linting task.
Suggestions
Add concrete Biome CLI commands with actual flags and examples, e.g., `biome check .`, `biome lint --apply src/`, `biome ci`, and show expected output patterns for common diagnostics.
Include a specific example workflow showing: a real Biome diagnostic message, the command to identify it, the safe fix command, and the validation rerun—not just abstract steps.
Replace generic agent behavior sections (Philosophy, Anti-Patterns, Constraints) with Biome-specific knowledge such as common rule categories, the difference between safe and unsafe fixes, and biome.json configuration patterns.
Add concrete CI integration examples showing exact commands for GitHub Actions or similar CI systems, since 'CI lint gates' is listed as a use case but no CI-specific guidance is provided.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is moderately efficient but includes several sections that are generic process boilerplate (Philosophy, Anti-Patterns, Constraints) rather than Biome-specific knowledge Claude doesn't already know. Sections like 'Avoid' and 'Constraints' contain general agent behavior guidance that adds little Biome-specific value. | 2 / 3 |
Actionability | The skill contains no concrete Biome commands, no executable code examples, no specific CLI flags, and no actual diagnostic patterns. Everything is abstract guidance like 'Inspect 2-3 focused surfaces' and 'Take the smallest action' without showing what a Biome command actually looks like (e.g., `biome check`, `biome lint --apply`, `biome ci`). | 1 / 3 |
Workflow Clarity | The workflow has a numbered sequence and mentions validation/rerun steps, and the Validation section includes a fail-fast pattern. However, the steps are abstract ('Classify the requested mode', 'Inspect 2-3 focused surfaces') with no concrete Biome-specific checkpoints, commands, or examples of what validation looks like in practice. | 2 / 3 |
Progressive Disclosure | The skill references a deferred context directory (`Infrastructure/references/deferred-skill-context/agent-ops-biome-linting/`) and instructs to load only what's needed, which is good structure. However, no bundle files are provided to verify these references exist, and the main content lacks the concrete Biome-specific material that should be present at the top level before deferring to references. | 2 / 3 |
Total | 7 / 12 Passed |