Content
92%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 lean workflow: concrete commands, an explicit validate-before-push checkpoint, ordering rationale, and delegation to complementary skills instead of duplicating them. The only weakness is that `gh pr create` and branch creation are named without example invocations, leaving minor actionability gaps.
Suggestions
Show a concrete `gh pr create` invocation (e.g. `gh pr create --title ... --body-file ...`) to close the actionability gap.
Give an example branch-creation command (e.g. `git checkout -b fix/description`) instead of the bare directive.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 37-line body is lean and assumes Claude's competence — every token either instructs or adds non-obvious rationale ('while corrections are still cheap', 'Both skills review their own prose — no separate pass is needed here', why /prose-review won't see commit messages). No padded explanation of git or PR concepts, matching the 'every token earns its place' anchor. | 5 / 5 |
Actionability | Concrete, copy-paste-ready commands appear throughout (`git status`, `git diff`, `git log --oneline -10`, push with `-u`, `gh pr create`, `/changelog <pr_number>`). Falls short of the 5 anchor only in minor gaps: `gh pr create` is named without example flags (title/body), and branch creation is a directive rather than a command. | 4 / 5 |
Workflow Clarity | A clear six-step sequence with an explicit validation checkpoint before the irreversible push ('Run `/prose-review branch` and fix anything it flags. Do this before pushing') and a second check on commit messages via `git log main..HEAD`, matching the anchor with explicit validation steps and fix loops. Not 4 — no meaningful validation gap remains. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines, single-purpose, and requires no external references; per the rubric's simple-skill guidance, well-organized sections alone qualify for 5. The body is cleanly sectioned with the numbered instructions carrying the entire workflow. | 5 / 5 |
Total | 19 / 20 Passed |