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 procedural skill body: lean, rule-dense, fully executable, with a clearly sequenced six-phase workflow, explicit validation and error-recovery paths for every failure mode, and textbook conditional loading of its one bundle reference. Nothing teaches concepts Claude already knows, and every instruction is copy-paste concrete down to the exact report and reply formats.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is telegraphic, rule-dense prose ('Exit 3 means a file was not found', 'A `?` is not a marker: a formula like `crit ? 2 : 1` passes') with zero concept-teaching — it never explains what an ADR, sprint, or QA gate is — so every token earns its place and it assumes Claude's competence. | 5 / 5 |
Actionability | Fully executable throughout: copy-paste commands ('bash .claude/scripts/story-facts.sh --lint --granularity <story_granularity> [--sprint | --all | <path> ...]', 'bash .claude/scripts/adr-status.sh'), exact report templates, exact fix texts for each failure mode, and exact fallback strings ('no sprint plan found'). | 5 / 5 |
Workflow Clarity | Six explicitly sequenced phases with validation checkpoints everywhere: exit-code and NOT_FOUND row handling, an empty-scope stop guard ('Never print a `Ready: 0 / Needs Work: 0` summary over an empty list'), a verdict-precedence ladder, and a gate-override flow with 'Never a silent READY'. The skill is read-only, so the destructive/batch cap does not apply, and batch-scope validation is present anyway. | 5 / 5 |
Progressive Disclosure | The single bundle reference (references/qa-lead-gate.md, verified to exist) is cited one level deep in Phase 5 with explicit conditional loading ('On a skip, do not load it'), and everything kept inline is needed on every run; clear phase sections and tables make navigation easy. | 5 / 5 |
Total | 20 / 20 Passed |