Content
88%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 high-quality, executable PR-landing playbook with concrete commands, strong validation checkpoints around a destructive merge, and a clear Do-Not guardrail section. Main weakness is minor over-explanation in a few prose lines rather than any structural gap.
Suggestions
Trim maintainer-common-sense prose like 'Maintainers own it.' where the preceding instruction already conveys the rule, to lift conciseness toward 5.
Consider moving the long `gh pr view`/`gh pr checks` field lists into a short reference snippet or a bundled script so the workflow prose stays scannable, improving progressive disclosure.
Soften the hard-coded absolute path '/Users/phaedrus/Projects/prompts/skills/autoreview/scripts/autoreview' to a discoverable or repo-relative invocation so the skill stays executable across machines.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Largely lean with no padding about what PRs or CI are, but a few lines over-explain maintainer common sense ('Do not expect external contributors to add Changesets metadata. Maintainers own it.') and could be trimmed. Not a 5 because some prose restates what the commands already imply. | 4 / 5 |
Actionability | Provides copy-paste-ready `gh` commands with exact JSON fields and flags (`--squash --match-head-commit "$head"`), covering the common ready-to-merge cases including a deterministic wrapper and manual fallback. | 5 / 5 |
Workflow Clarity | An 8-step sequence with explicit validation checkpoints — head-SHA pinning re-read before merge, checks must be complete on the pinned SHA, branch review only from a matching HEAD, abort if SHA changed — plus feedback loops for a destructive merge operation, satisfying the destructive-skill validation requirement. | 5 / 5 |
Progressive Disclosure | A single-file skill with no bundle files (references/, scripts/, assets/ absent) and clean section structure (Workflow, Do Not). For a no-bundle skill this is well-organized; not a 5 only because there is no one-level-deep reference navigation to signal, which is appropriate but not exemplary for this dimension. | 4 / 5 |
Total | 18 / 20 Passed |