Content
78%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, actionable instruction skill with a clear sequenced workflow and verification feedback loop for a destructive-ish PR-metadata operation. It earns top marks for disclosure but has minor redundancy and a missing executable command for the existing-PR edit path.
Suggestions
Add the concrete command for updating an existing PR body (e.g. 'gh pr edit <num> --body-file body.md') alongside the existing 'gh pr create -T …' example so both paths are copy-paste ready.
Tighten the Quick Checks section to avoid restating the pkg-scope naming rule and the template HTML-comment rule already covered in Workflow; cross-reference instead of duplicating.
Make the post-update validation a hard gate by stating that the PR body edit is only considered complete once bot-gated labels (do-not-merge/needs-linked-issue, needs-tests-checked) have cleared, not just that they should be re-checked.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and assumes competence, but the Quick Checks section repeats the pkg-scope rule and the template HTML-comment rule already stated in Workflow, adding mild redundancy. | 4 / 5 |
Actionability | Provides a concrete copy-paste command ('gh pr create -T .github/pull_request_template.md') and names exact safe/unsafe targets, but omits an executable command for editing existing PRs (only describes mutable sections). | 4 / 5 |
Workflow Clarity | A clear 7-step sequence with a pre-flight review checkpoint (step 6) and a post-update verify/diff feedback loop (step 7), but the validation is advisory rather than a strict 'do not proceed until labels clear' gate. | 4 / 5 |
Progressive Disclosure | Under 50 lines, single-purpose, with well-organized Overview/Workflow/Quick Checks sections and no need for external bundle references; the only references are repo files and a sibling skill, one level deep. | 5 / 5 |
Total | 17 / 20 Passed |