Content
96%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.
An excellent procedural skill body: fully executable commands, a clearly sequenced five-phase workflow with explicit CI/review validation loops and safety rules, and near-zero token waste. The only structural consideration is that some denser procedural detail (PR body construction, resolution-loop mechanics) could be moved to reference files to lighten the top-level SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~110-line body is almost entirely exact commands and terse directives with no explanation of concepts Claude already knows; sections like the Rules block and PR-body instructions are maximally compressed, so every token earns its place. | 5 / 5 |
Actionability | Nearly copy-paste-ready throughout: exact gh/git commands including the GraphQL review-thread query and resolveReviewThread mutation, PR-number extraction via grep -oE '[0-9]+$', and explicit handling of the git-ignored local/ directory. Placeholders like <COMMENT_ID> and <PRRT_...> are inherent dynamic substitution points, not missing detail. | 5 / 5 |
Workflow Clarity | Five clearly sequenced phases with explicit validation checkpoints and a genuine feedback loop: gh pr checks --watch, a repeat-until-green resolution loop, re-check after each push, a 5-iteration cap before reporting blockers, and a rule never to mark ready without user request. This matches the top anchor with error-recovery loops. | 5 / 5 |
Progressive Disclosure | No bundle files exist and nothing that belongs in a separate file is inlined — the single well-sectioned file with phase headers is appropriately structured. However, at ~105 lines it exceeds the under-50-line simple-skill exception and offers no one-level-deep references for its longer procedural detail (e.g., the PR-body construction or resolution-loop specifics), so it fits the good-structure-with-minor-gaps anchor rather than the clear-overview-with-references anchor. | 4 / 5 |
Total | 19 / 20 Passed |