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.
The content is a strongly actionable, well-sequenced workflow with concrete gh commands, explicit verification checkpoints, and error-recovery paths. Its main weaknesses are minor: a few motivational lines could be trimmed and the 'Important notes' section overlaps with the steps. The description frontmatter, not the body, is the skill's weak point.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is command-driven and assumes Claude's competence (no explanations of git or PR concepts), with only minor trimmable lines such as 'Read the template carefully to understand all sections and requirements' and 'This helps reviewers understand the journey, not just the destination'. It is efficient with minor over-explanation, fitting the level-4 anchor rather than 5. | 4 / 5 |
Actionability | Every step provides copy-paste-ready commands with exact flags (e.g., 'gh pr view --json url,number,title,state 2>/dev/null', 'gh pr diff {number}', 'gh pr edit {number} --body-file ...'), concrete file paths, and explicit checkbox formats ('- [x]' / '- [ ]'). Concrete commands cover the common cases including missing template, missing PR, and gh repo set-default errors. | 5 / 5 |
Workflow Clarity | Steps 1-9 form a clear sequence with explicit validation checkpoints: step 3 detects and reads an existing description, step 6 runs verification commands with pass/fail handling ('If it passes, mark the checkbox as checked... If it fails, keep it unchecked and note what failed'), and step 4 includes error recovery for the missing-default-remote failure. This matches the level-5 anchor of explicit validation with feedback loops. | 5 / 5 |
Progressive Disclosure | The body is well-sectioned (Steps, Important notes) and self-contained with no external bundle files to misnavigate. It is over 50 lines so the simple-skill 5 exception does not strictly apply, and the 'Important notes' section partially duplicates step content (e.g., 'Always attempt to run verification commands' restates step 6), leaving minor organization gaps consistent with the level-4 anchor. | 4 / 5 |
Total | 18 / 20 Passed |