Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A tight, well-sequenced, mostly executable workflow with good validation checkpoints and clean section organization. Its one weak spot is the PR-body step, which sketches a temp-file approach but omits the command that actually applies the body to the PR.
Suggestions
Specify the command that attaches the PR body temp file to the PR (e.g. `gh pr edit --body-file pr-body.md`), since `--fill` populates from commit messages and won't use the custom body, and the current "run pr-body.md" is ambiguous.
Replace the "pr-body.md ... EOF" sketch with a concrete copy-paste-ready heredoc example so the body-writing step is fully executable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and terse — short bullet points with concrete commands and no explanation of git/gh concepts Claude already knows, so every token earns its place. | 3 / 3 |
Actionability | Most steps are concrete executable commands, but the PR-body step ("e.g. pr-body.md ... EOF" and "run pr-body.md") is incomplete: it never specifies the command that attaches the temp file to the PR, and `--fill` will not consume a custom body, leaving a missing key detail. | 2 / 3 |
Workflow Clarity | The multi-step flow is clearly sequenced with a pre-stage checkpoint ("Confirm status, then stage everything") and explicit feedback loops (check-fail→install→rerun once; push-fail→pull→retry), matching the clear-sequence-with-validation anchor. | 3 / 3 |
Progressive Disclosure | This is a simple, single-purpose skill under 50 lines with well-organized sections (Prerequisites, Naming conventions, Workflow); the unreferenced assets are decorative icons, not nested references, so the simple-skills note applies. | 3 / 3 |
Total | 11 / 12 Passed |