Content
86%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 an exemplary terse, instruction-only skill: concrete validation commands, specific scope mappings, before/after repair examples, and a numbered workflow with a title-validation checkpoint. Its only soft spots are the absence of a full gh pr create/edit example invocation and no explicit post-edit validation loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lines like "Use the smallest valid scope; do not invent scopes" and "Keep the body terse. Include only reviewer-useful context" are lean, assume Claude's competence, and contain no concept explanations or padding — every token earns its place. | 5 / 5 |
Actionability | Concrete commands appear throughout ("conventional-prs --input '<title>'", "gh search issues / gh search prs", "--body-file", "do not rely on unchecked --fill") plus copy-paste repair examples like "fix: UI bug" → "fix(UI): prevent item repair menu from hiding refittable items"; the minor gap is that no full gh pr create/edit invocation is shown, keeping it below fully copy-paste-ready anchor 5. | 4 / 5 |
Workflow Clarity | The 6-step Workflow has a clear sequence with an explicit title-validation checkpoint (step 4) and a Repairs section covering error recovery, but there is no explicit re-validation loop after body edits or validation of the final PR state, matching 'clear sequence with most checkpoints; minor validation gaps'. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines with no external bundle references needed (no references/, scripts/, or assets/ exist), and its sections (Sources, Title gate, Body gate, Workflow, Repairs) are well-organized — meeting the simple-skill exception for a top progressive-disclosure score. | 5 / 5 |
Total | 18 / 20 Passed |