Content
81%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 well-structured, highly actionable instruction skill with real bundle references, explicit validation gates, and a complete output template plus worked example. Its main weakness is token efficiency: the SDK proof ladder is duplicated in full and the First-Principles Gate section adds abstract padding.
Suggestions
Deduplicate the SDK handoff proof ladder: state it once (or move it to a references/ file) instead of repeating the full gate list in both Workflow step 7 and the Validation section.
Trim or compress the First-Principles Gate section into a short decision statement; its enumerated abstract fields (rejected assumptions, rejected alternatives) add tokens without guiding execution.
Clarify the status of the external "Infrastructure/references/…" paths in the References section — either mark them as environment-dependent or replace them with the package-local "references/" contents that are actually shipped.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and mostly free of explanations of known concepts, but the SDK handoff proof ladder is written out in full twice (Workflow step 7 and the Validation section), and the "First-Principles Gate" section is abstract boilerplate padding. Mostly efficient with clear tightening opportunities — anchor 3, not 2, since most lines carry real guidance. | 3 / 5 |
Actionability | Guidance is copy-paste ready for an instruction-only skill: a concrete YAML output template, a fully worked example with expected output, executable validation commands ("./bin/ask skills audit … --level strict --json --robot"), and specific thresholds ("Treat oss-local misses as 70-75 discovery-band repair inputs"). Matches the anchor for fully executable, common-case-covering guidance. | 5 / 5 |
Workflow Clarity | The seven-step workflow is clearly sequenced with explicit validation checkpoints ("stops at the first failed gate"), a fail-fast rule, and error-recovery loops via the Failure Mode section and the blocked_by mechanism. Destructive actions (merge, fold, retire, publish) are explicitly gated behind approval, satisfying the destructive-operation validation requirement. | 5 / 5 |
Progressive Disclosure | Structure is good: the four referenced files (taxonomy.md, discovery-interview.md, evidence-routing.md, harness-evidence-mapping.md) all exist in the bundle, are clearly signaled, and are one level deep. Minor gaps: the long proof-ladder detail is inlined rather than split to a reference, and the References section lists external "Infrastructure/references/…" paths that are not part of the bundle. Anchor 4 rather than 5's cleanly split, easily navigable structure. | 4 / 5 |
Total | 17 / 20 Passed |