Content
75%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, actionable, well-structured gated workflow with explicit validation and a usable template. Its main limitation is rule-style rather than numbered-step presentation and a partially-specified `gh` command.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence without explaining concepts Claude already knows; minor redundancy between Status Rules, the Execution Gate, and the Handoff section keeps it just short of fully efficient. | 4 / 5 |
Actionability | Provides a copy-paste issue body template, a default `gh issue create` command, and concrete valid/invalid acceptance-criteria examples; the `gh` invocation is not fully specified with flags, leaving a minor gap. | 4 / 5 |
Workflow Clarity | The gated workflow has explicit validation checkpoints (acceptance criteria gate, execution gate) and a feedback loop (stop and request criteria when draft), but the sequence is presented as rules rather than a numbered step list with explicit recovery steps. | 4 / 5 |
Progressive Disclosure | Content is well-organized into clearly labeled sections with no external references needed for this single-purpose skill; at over 50 lines it does not qualify for the simple-skill 5, and the inlined template is short enough to stay inline. | 4 / 5 |
Total | 16 / 20 Passed |