Content
50%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a reasonably comprehensive, well-sectioned PR-management reference with real executable gh CLI commands, but it is monolithic, padded with basic concept explanations and a stray config block, and its merge workflows lack explicit validation checkpoints. Splitting reference material into bundle files and tightening the prose would lift it notably.
Suggestions
Remove the duplicate YAML config/hooks block at the top of the body (lines 6–31) — it is leaked configuration noise, not skill guidance.
Add explicit validation checkpoints to the merge workflows, e.g. 'Run `gh pr checks` and only proceed to `gh pr merge` when all checks are passing.'
Move the PR description template and full command reference into separate reference files (e.g. references/pr-template.md, references/gh-commands.md) and link to them from SKILL.md to improve progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly organized reference material, but it pads in concepts Claude already knows (basic squash/merge/rebase explanations) and leads with a stray leaked YAML config/hooks block that earns no value. | 2 / 3 |
Actionability | The 'Common Commands' section gives genuinely executable `gh pr create/review/status/merge` commands, but the workflow-pattern steps are abstract ('Create PR with detailed description', 'Assign reviewers') with placeholder arguments, so guidance is concrete but incomplete. | 2 / 3 |
Workflow Clarity | Workflows are sequenced with numbered lists, but merging is a partially destructive operation and the steps lack explicit validation checkpoints (e.g. verify all CI checks pass before merge), which caps clarity at 2 per the rubric. | 2 / 3 |
Progressive Disclosure | Content is a single monolithic ~180-line file with no bundle files and no external references; sections are organized, but material that could be split out (PR description template, command reference, swarm setup) is all inline, so it sits at level 2 rather than 3. | 2 / 3 |
Total | 8 / 12 Passed |