Content
75%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 a strong, executable workflow with concrete commands, clear sequencing, and useful examples that assume Claude's intelligence. Minor gains are available by reducing example redundancy and adding an explicit post-creation verification checkpoint.
Suggestions
Add an explicit verification step after Step 4 (e.g. confirm the PR opened with `gh pr view` and report its URL).
Consider trimming to one or two example PR descriptions and moving the issue-reference table or examples to a reference file to improve token efficiency and progressive disclosure.
Replace the manual BASE/PR_NUMBER substitution with a concrete note or a small script snippet so commands are fully copy-paste ready.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence (no explanation of what a PR or git is); it only loses a point for three full example PR descriptions that add length beyond what one or two would convey. | 4 / 5 |
Actionability | Provides concrete, copy-pasteable commands (gh repo view, git status, git log, git diff, gh pr create, gh api) with specific title formats; the BASE and PR_NUMBER placeholders requiring manual substitution are the minor gaps keeping it from 5. | 4 / 5 |
Workflow Clarity | A clear four-step sequence (Verify Branch State, Analyze Changes, Write Description, Create PR) with a prerequisite check (git status --porcelain); it lacks an explicit post-creation verification step, which is the minor checkpoint gap. | 4 / 5 |
Progressive Disclosure | Well-organized into clearly headed sections with inline content and external doc links at the end; since the skill exceeds 50 lines and inlines three full examples plus an editing section, it does not qualify for the simple-skill 5. | 4 / 5 |
Total | 16 / 20 Passed |