Content
81%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.
A well-structured, mostly lean PR-creation workflow with strong sequencing and explicit validation/verification throughout. Minor improvements are possible in trimming rationale and providing a complete ready-to-run gh pr create example.
Suggestions
Tighten the base-resolution section by collapsing the repeated rationale into the ordered list to reduce redundancy.
Add a complete copy-paste `gh pr create` example (with --base, --title, --body, optional --draft) so the creation step is fully executable rather than described.
Consider extracting the fallback PR template into a reference file so the main body stays a lean overview, which would also strengthen progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence (no primers on what a PR or GitHub is), but a few elaborative sentences (e.g., the repeated base-resolution rationale) could be trimmed, placing it just below the every-token-earns-its-place anchor at 5. | 4 / 5 |
Actionability | It gives concrete commands (gh pr create with --draft/--base, $prp-commit, git status) and bad/good title examples, but the final gh pr create invocation is described rather than given as a complete copy-paste example, leaving minor gaps versus the fully-executable anchor at 5. | 4 / 5 |
Workflow Clarity | A clear five-step sequence with explicit validation checkpoints and feedback loops (re-read git status after commit, fetch remote state, verify the created PR exists, do not report success until GitHub confirms) matches the clear-sequence-with-validation anchor. | 5 / 5 |
Progressive Disclosure | The skill is a single self-contained file with well-organized sections and no nested or buried references, but at ~100 lines it exceeds the under-50-line simple-skill threshold, so it does not reach the clear-overview-with-one-level-references anchor at 5. | 4 / 5 |
Total | 17 / 20 Passed |