Content
82%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.
The body is a tight, highly actionable gate workflow with a concrete command, a full issue template, and an explicit acceptance-criteria checkpoint. Its only real gaps are minor status-value repetition and a hand-off rather than a full retry loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence with no concept padding, but the Status values are restated across the Required Fields list, Status Rules, and the template, leaving minor redundancy that fits anchor 4 rather than 5. | 4 / 5 |
Actionability | It provides a concrete command ("gh issue create"), a copy-paste body template, concrete valid/invalid acceptance-criteria examples, and explicit status definitions, fully covering the common case per anchor 5. | 5 / 5 |
Workflow Clarity | The create -> gate -> set-status -> block/allow-execution sequence is clear with the acceptance-criteria gate as an explicit checkpoint and a recovery path ("stop and request user-provided acceptance criteria"), but the recovery is a hand-off rather than a validate-fix-retry loop, matching anchor 4. | 4 / 5 |
Progressive Disclosure | No bundle files exist, so the single self-contained SKILL.md is appropriately organized into well-labeled sections (Overview, Required Fields, Gate, Template, Status Rules, Handoff) with no nested references, fitting anchor 4; it is slightly over the simple-skill line count so not a 5. | 4 / 5 |
Total | 17 / 20 Passed |