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-engineered procedural skill: concrete commands, copy-ready templates, hard gates with stop conditions, and error-recovery guidance make it fully actionable with a clear validated workflow. The only notable gaps are mild token redundancy from repeated "post immediately" rules and a red-flags table that restates inline rules.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is imperative and lean with no explanations of concepts Claude already knows; every gate, template, and command earns its place. Not 5: "Do not wait for the user to approve" is repeated in the intro, section 6, and the red flags table, and the red flags table restates several rules already given inline. | 4 / 5 |
Actionability | Fully executable throughout: concrete commands ("git log --oneline base...HEAD", "gh pr list --limit 15 --state all --json title", "gh pr create --title \"...\" --body-file ...", "gh pr edit ...") plus copy-ready markdown templates for Root cause, Possible alternatives, and Public API change. Specific examples cover the common fix/feat/chore cases. | 5 / 5 |
Workflow Clarity | Six clearly sequenced steps with explicit validation checkpoints (the HARD-GATE: "If none of those exist, stop... Wait until they add one, then continue"), feedback loops for error recovery ("If `gh` fails, stop and show the error. Leave the drafted body in the chat"), fix-PR gating via bugfix-pr, and a red-flags self-correction checklist. | 5 / 5 |
Progressive Disclosure | Single-file skill (no references/scripts/assets bundle exists) with well-organized sections, a classification table, and clearly signaled one-level-deep pointers to sibling skills (.claude/skills/simple-english/SKILL.md, i-have-adhd). Not 5: at ~200 lines, the long body-section spec and the partially duplicative red flags table could be trimmed or moved to a reference file. | 4 / 5 |
Total | 18 / 20 Passed |