Content
93%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 exemplar of lean, actionable skill writing — every token is a constraint, command, or example rather than explanation. The single weakness is a workflow step ('uncommitted changes') whose failure path is never specified, leaving a small ambiguity in an otherwise well-validated sequence.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and directive-only: it explains no concepts Claude already knows (no PR or conventional-commit primers), and every section — Title Rules, Body Rules, Error Handling — carries constraints Claude would not infer on its own. The one-line intro duplicates the frontmatter description only slightly and serves as a legitimate summary. | 5 / 5 |
Actionability | Fully executable guidance throughout: the exact create command ('gh pr create --draft --title "<type>(<scope>): <subject>" --body-file <file> --base main'), three example titles, a default body template, a complete worked example body, and copy-paste common actions. | 5 / 5 |
Workflow Clarity | A clear 4-step sequence opens with validation ('gh auth status, current branch, uncommitted changes') and an Error Handling section provides recovery paths, but the uncommitted-changes check names no action (commit? abort?) and there is no post-create confirmation step — minor validation gaps that fit the anchor 4 rather than 5. | 4 / 5 |
Progressive Disclosure | No bundle files exist, and none are needed: the ~93-line body is well-sectioned (Workflow, Title Rules, Body Rules, Common Actions, Error Handling), cohesive, and contains nothing that belongs in a separate reference file, so navigation within SKILL.md is easy with no deep-reference risk. | 5 / 5 |
Total | 19 / 20 Passed |