Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured, concise review workflow with concrete commands and clear sequencing. Its main weakness is reliance on an external docs/REVIEW_PROMPT.md for the actual review criteria, which is not bundled with the skill.
Suggestions
Inline the key review criteria (or a condensed rubric) into SKILL.md, or include docs/REVIEW_PROMPT.md as a bundled reference file so the skill is self-contained and the criteria are verifiable.
Add a brief validation checkpoint after fetching PR data (e.g., confirm the diff/non-empty files were retrieved) so command failures are caught before review begins.
Reduce the slight redundancy between the 'Review Criteria' list and the 'Issue Categories' table by cross-referencing one from the other.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean: numbered steps, concrete gh commands, a compact category table, and a defined output format, with no explanation of concepts Claude already knows and only minor redundancy between the criteria list and category table. | 3 / 3 |
Actionability | Concrete executable gh commands ('gh pr view ... --json ...', 'gh pr diff ...') and a clear output structure are present, but the substantive review criteria are delegated to an external 'docs/REVIEW_PROMPT.md' that is not part of the skill bundle, leaving the actionable review guidance incomplete. | 2 / 3 |
Workflow Clarity | A clearly sequenced per-PR workflow with an explicit checkpoint ('If files changed > 15, flag for potential split'), a re-review protocol that checks prior status, and a multi-PR loop with a final confirmation step provide good sequencing and feedback for a non-destructive task. | 3 / 3 |
Progressive Disclosure | The body is organized into clearly labeled sections (Arguments, Steps, Re-review Protocol, Review Criteria, Issue Categories, Output Format, Multi-PR Workflow) with a single clearly-signaled one-level external reference and no nested reference chains. | 3 / 3 |
Total | 11 / 12 Passed |