Content
71%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-designed router-style SKILL.md with explicit load triggers, a clear workflow diagram, quality gates, and good escape-hatch handling. Its main defects are redundant disclaimers, a validation/recovery loop that is only delegated rather than stated, and — most seriously — 11 referenced bundle files (all of detection/ and templates/) that are missing from the package, leaving nearly half its navigation links broken.
Suggestions
Ship the missing bundle files (detection/stage_detector.md, detection/quality_checker.md, and the nine templates/*.md files) or remove/correct those sections — every 'Templates — Load on Demand' row currently links to a nonexistent path.
State the gate failure recovery loop inline (gate check fails → fix backlog items → re-run gate) so the feedback loop is explicit in the body rather than only implied by references/gates.md.
Deduplicate the disclaimer (it appears in both Input Validation and Escape Hatches) and trim the 'When to Use' section, which repeats the frontmatter description.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly tight — tables, short sections, and pointer lines like '→ Full details: [references/quick_reference.md]' rather than inlined detail, and it explains nothing Claude already knows. However, the disclaimer appears twice ('Disclaimer (Required)' in Input Validation and again in Escape Hatches), and the 'When to Use' section largely restates the frontmatter description. These minor redundancies fit 'efficient; minor instances that could be trimmed' rather than the every-token-earns-its-place anchor at 5. | 4 / 5 |
Actionability | As an instruction-only router skill, it gives mostly executable guidance: a verbatim out-of-scope response to quote, concrete command names (/ps intake, /ps gate check contribution), explicit load conditions for every reference file, and a clear workflow diagram. What keeps it from 5 is that the core how-to (review lenses, backlog structure, gate criteria) is entirely delegated to files, and some lines like 'Review an academic paper and identify issues' describe rather than instruct — minor gaps, not the missing-steps pattern of 3. | 4 / 5 |
Workflow Clarity | The sequence INTAKE → PLANNING → REVIEW → AMENDMENT → BACKLOG → SPRINT REVIEW & RETRO → NEXT SPRINT / GATE is explicit, with quality gates between stages, a mandatory human-finalization checkpoint, and escape hatches. It is not a 5 because the body itself never states the gate-fail recovery loop (gate check fails → fix → re-check) explicitly — that feedback loop is only implied via the gates reference — which matches 'clear sequence with most checkpoints present; minor validation gaps'. | 4 / 5 |
Progressive Disclosure | The hub structure is textbook — every reference has 'When to load' triggers and a 'Contents' summary, one level deep — but scored against the actual bundle, 11 of the 20 referenced paths are dangling: detection/stage_detector.md, detection/quality_checker.md, and all nine templates/*.md files do not exist in the bundle (only the 8 references/*.md files resolve, and intake.md itself points to the missing detection/stage_detector.md). Following nearly half the navigation links dead-ends, which is a material organization failure beyond the 'minor organization gaps' of anchor 4, while the strong signaling keeps it above anchor 3's 'references not clearly signaled' — it sits between 3 and 4, at 3 because broken paths materially impair navigation. | 3 / 5 |
Total | 15 / 20 Passed |