Content
100%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.
An exemplary skill body: lean, rule-dense prose with a decisive one-line test, an 8-class taxonomy of concrete quoted patterns with per-class fixes, sanctioned keep rules to prevent overcorrection, and a 5-step workflow with explicit validation gates. Progressive disclosure is correctly implemented with both referenced files present and well-signaled.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every sentence carries a rule ('The fix is never deletion alone when a passage carries factual clauses — restate each so it stands at HEAD, then delete the transcript around it') with zero padding and no explanation of concepts Claude already knows. The 45-line body assumes competence and every token earns its place. | 5 / 5 |
Actionability | Concrete quoted leak patterns with a specific fix per taxonomy class ('a fixed regression becomes a present-tense counterfactual ("without X, Y happens"), never repo history'), executable tooling (run the recall batteries 'with --hidden so .agents/ is searched'), named verification gates ('doc-sync for docs, verify-type-equiv, verify-translation-pairing'), and per-surface fix routing. Specific guidance covers the common cases for this instruction-only skill. | 5 / 5 |
Workflow Clarity | A clear 5-step sequence (scope/exclusions → read-only audit → owner-first fix → pre-deletion proposition and trap check → verify) with explicit validation checkpoints and expected outcomes ('re-run the batteries expecting only sanctioned keeps, this skill's own directory, and the owning note's quoted evidence'), plus the overcorrection-traps checklist. The destructive-operation validation cap is fully satisfied. | 5 / 5 |
Progressive Disclosure | The body is an overview only; few-shot calibration (references/examples.md, 253 lines) and the rg batteries (references/recall-batteries.md, 43 lines) are appropriately split into one-level-deep files, each linked with a stated purpose and a resolvable anchor (examples.md#overcorrection-traps exists at line 211). Both bundle files exist and contain exactly what the body claims. | 5 / 5 |
Total | 20 / 20 Passed |