Content
90%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.
This is a dense, high-signal instruction skill: a complete template, exact commands, and per-case rules with genuine validation feedback loops, and essentially no wasted tokens. The only structural improvement would be presenting the overall process (run spec → draft body → create PR) as one explicit ordered sequence and, if the skill grows, splitting the evidence/changelog rules into a referenced file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and efficient throughout: every line is a project-specific rule Claude could not infer (template shape, word budget, changelog-agent integration, evidence binding to commits), with zero explanation of concepts Claude already knows. The two-sentence opening frames the skill's philosophy rather than padding it, so it matches the top anchor rather than level 4. | 5 / 5 |
Actionability | Fully executable guidance: a complete copy-paste PR template with per-section content rules, exact commands (`gh pr create --base dev --title "<type>(<scope>): <change>" --body-file /tmp/pr-body.md`, `gh workflow run pr-proof.yml --ref <branch> -f pr=<number>`), and a worked example of an Evidence line. Common cases (no spec changed, UI changes, rebase) are each covered with a specific instruction. | 5 / 5 |
Workflow Clarity | Validation checkpoints and feedback loops are explicit — run the spec before opening, "Red evidence is fixed, not narrated: fix the spec or the code and rerun it", rerun after rebase, and the before-section consistency check — but the end-to-end sequence (run spec → write body → create/edit PR) is implied across sections rather than given as one explicit ordered workflow. This sits between the level 4 anchor (clear sequence, most checkpoints) and level 5 (fully explicit sequenced workflow with checklists). | 4 / 5 |
Progressive Disclosure | A single well-sectioned file (The shape / Evidence / Leave out / Do it) with no bundle files and no content that clearly belongs in a separate file; the template must stay inline. It meets the level 4 anchor (good structure, content appropriately placed), but at ~90 lines with no external references or navigation pointers it does not demonstrate the well-signaled one-level-deep reference structure of level 5. | 4 / 5 |
Total | 18 / 20 Passed |