Content
88%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.
A lean, expert-level instruction body: tightly written imperative guidance, exact codebase artifacts, a sequenced pipeline with validation checkpoints and a review checklist, plus executable test commands. The only structural improvement would be moving per-plugin option-model/conversion detail into reference files, and the only actionability gap is the absence of one worked code example.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, imperative, and domain-specific throughout ("Preserve source nesting until conversion", "Copy a current analogous arm rather than relying on remembered struct fields") with no padding and no explanation of concepts Claude already knows — every token earns its place. | 5 / 5 |
Actionability | Provides concrete file names, exact symbols (`migrate_eslint_rule()`, `RuleConf<T>`, `RuleFixConfiguration::WithOptions`), fixture paths, and copy-paste commands (`cargo test -p biome_cli migrate_eslint`). Minor gaps remain: no Rust snippet for a conversion or typed-variant arm, instead deferring to existing analogous code. | 4 / 5 |
Workflow Clarity | Sections follow the declared four-part pipeline in order (preconditions → model → convert → typed variant → wire migration → tests), with explicit validation steps ("Run the focused migration tests and inspect adjacent snapshots", "Search the enum's matches after adding the variant") and a closing Review Checklist — a clear sequence with checkpoints and a checklist. | 5 / 5 |
Progressive Disclosure | Well-sectioned single-file body with a clearly signaled References section pointing to real codebase paths; however, no bundle files exist and the ~130-line body keeps everything inline, so it falls short of anchor 5's cleanly split, reference-file structure (and exceeds the under-50-lines simple-skill carve-out). | 4 / 5 |
Total | 18 / 20 Passed |