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.
A tight, repo-specific SOP that delegates the canonical PR policy to CONTRIBUTING.md and adds only the surrounding steps: pre-flight baseline verification, body drafting, and push/create commands. Its one weakness is the undefined `$BODY` variable in the otherwise copy-paste-ready gh command.
Suggestions
Show how $BODY is materialized before `gh pr create` (e.g., write the drafted body to a temp file and pass its path via --body-file) so the command is fully self-contained.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and delegates the SOP ('this skill only adds the steps around it') while assuming Claude's competence with git and gh; every line carries repo-specific, non-obvious information with no padding. | 5 / 5 |
Actionability | Commands are copy-paste ready with sensible placeholders (`git push -u origin HEAD`, the full `gh pr create` invocation, `git restore --source=HEAD ...`, the gradle baseline chain, the commit-pinned raw URL format), but `$BODY` is referenced in the gh command without ever being defined or materialized, a minor executable gap that keeps it below anchor 5. | 4 / 5 |
Workflow Clarity | The three sections are clearly sequenced with an explicit validation gate ('Baseline must be green this session... If it hasn't run since the last code change, run /baseline first') that includes a recovery path, plus pre-push git status checks and a final reporting step. | 5 / 5 |
Progressive Disclosure | At under 50 lines with no bundle files needed, the skill is well organized into three numbered sections and its repo-file references (CONTRIBUTING.md sections) are clearly signaled one level deep with exact section paths. | 5 / 5 |
Total | 19 / 20 Passed |