Content
88%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, lean triage skill with concrete commands, explicit stop/checkpoint rules, and a verification checklist. The main room for improvement is in actionability of the judgement-based steps and splitting detail into bundle files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — it never explains what issues, PRs, or triage are, and every section (When To Use, Stop rules, Output Contract) earns its place rather than padding context. | 5 / 5 |
Actionability | Concrete commands are present throughout (`gh issue list`, `gh pr list`, `bd ready`, `gh issue edit --add-label`, `bd update`) plus a copy-paste comment-posting block, but the categorise/verify/brief steps are judgement guidance rather than executable code, leaving minor gaps. | 4 / 5 |
Workflow Clarity | A clearly sequenced 5-step workflow with explicit validation checkpoints (the Verify step, the Stop Or Checkpoint Rules) and a closing Verification checklist; because validation is present for the destructive/batch moves (closing, labelling), the missing-validation cap does not apply. | 5 / 5 |
Progressive Disclosure | Well-organized into clear sections with only one-level cross-references to sibling skills (no nested detail chains), but at ~130 lines with no bundle files to offload detail into, it does not qualify for the simple-skill 5 and has minor organization gaps. | 4 / 5 |
Total | 18 / 20 Passed |