Content
77%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 strong, highly actionable skill body with an excellent workflow: concrete commands, complete executable examples, and genuine validation checkpoints (PETE verdict handling, '@:' tag self-scan). The main weakness is structure, not substance — the body inlines template/example material that duplicates the never-linked references/pr-templates.md and repeats the tag-safety rule multiple times.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly dense, useful guidance, but there is more than minor tightening to do: the '@:' tag-safety rule is stated three times (dedicated section, a Tips bullet, and inside Step 4), the opening narration ("This skill helps you create comprehensive PR bodies...", "I'll guide you through...") adds little, and the inline Templates/Examples sections (~120 lines) duplicate content that already exists in references/pr-templates.md. Anchor 3 (mostly efficient, could be tightened) fits better than 4 (only minor trims). | 3 / 5 |
Actionability | Fully executable throughout: exact script path and usage with formats ("./scripts/fetch-test-tags.sh [format]" with markdown/json/list, matching the actual script), concrete commands ("gh issue view", "pbcopy", "gh pr edit"), and two complete copy-paste-ready example PR bodies covering the common bug-fix and feature cases. Matches anchor 5. | 5 / 5 |
Workflow Clarity | A clear 5-step sequence (gather context → fetch tags → PETE evaluation → generate body → output) with explicit validation checkpoints and feedback loops: "If PETE reports Insufficient, I'll say so and suggest concrete additions ... before we finalize the PR body" and "Before finalizing any PR body, scan your own draft for '@:' outside the Validation Steps section and reword those away." The operation is not destructive/batch, so no cap applies; matches anchor 5 (explicit validation, error-recovery guidance). | 5 / 5 |
Progressive Disclosure | The script reference (scripts/fetch-test-tags.sh) is real and accurately documented, but references/pr-templates.md (327 lines) exists in the bundle and is never linked from the body — instead the '## PR Body Templates' and '## Examples' sections inline ~120 lines of substantially the same template/example content. Anchor 3 (content that should be separate is inline; references present but not clearly signaled) is the best fit; anchor 4 would require the bulk of template material to live in the referenced file. | 3 / 5 |
Total | 16 / 20 Passed |