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.
An exemplary process skill body: lean, opinionated, and immediately executable, with a well-sequenced workflow, explicit stop checkpoints, and a verification checklist that addresses the exact batch-operation hazards this rubric worries about. The only residual gaps are small — a missing example note and no progressive-disclosure layering — neither of which impedes execution.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~125-line body is dense and assumes Claude's competence — no concept re-teaching, no filler, every section carries operational guidance. Lines like "An unverified bug report is a hypothesis" and "Titles are written by people who already know what they meant" are compact judgment calls, not padding, so the anchor-5 fit (every token earns its place) holds over anchor 4. | 5 / 5 |
Actionability | Concrete and mostly executable: a copy-paste-ready bash snippet routing comments through the safe-gh-comment gate, specific commands (`gh issue list`, `bd ready`, `gh issue edit --add-label`, `bd update`), and defined states with criteria. Falls short of anchor 5 only for minor gaps — no example of an actual TRIAGE_NOTE or a per-state label command sequence for the common cases. | 4 / 5 |
Workflow Clarity | A clear five-step sequence (Categorise → Verify → Assign state → Write brief → Record) with explicit checkpoints: a dedicated Stop Or Checkpoint Rules section ("Stop before closing anything a human filed deliberately", "One item at a time") and a closing Verification checklist. The batch-labeling hazard this rubric flags is explicitly countered ("Batch-labelling a queue without reading it is how real reports end up buried"), matching the anchor-5 profile of explicit validation plus checklists. | 5 / 5 |
Progressive Disclosure | No bundle files exist and the single-file body is cleanly sectioned with well-signaled cross-references to sibling skills (skill-issues, skill-code-review, skill-pressure-test, skill-work-slicing) at one level deep. It fits anchor 4 (good structure, content appropriately placed) rather than 5 because everything is inline with no progressive layering — acceptable at ~125 lines but not the clear overview-plus-references structure the top anchor describes. | 4 / 5 |
Total | 18 / 20 Passed |