Content
92%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 executable, well-structured review-loop workflow with explicit validation feedback loops and concrete commands throughout. The only weak spot is a few inline gotcha asides written as prose paragraphs that could be tightened for token efficiency.
Suggestions
Tighten the inline command-annotation asides (e.g. the `.body | tail -1` warning at the step-1 block and the `--reverse` note at step 7) from multi-sentence prose to one-line parentheticals so they earn their tokens without padding.
Consider moving the longer jq/git gotcha explanations into a short 'Pitfalls' subsection or a reference file so the core loop steps read as terse, scannable commands.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and assumes Claude's competence (no explaining what a PR/Greptile/thread is), but several inline gotchas are written as multi-sentence prose paragraphs (e.g. the `.body | tail -1` warning and the `--reverse` justification) that could be tightened to one line each. | 4 / 5 |
Actionability | Fully executable throughout: concrete `gh`/`git`/GraphQL commands with real flags, exact API queries, copy-pasteable re-trigger mentions, and a specific ScheduleWakeup fallback delay, covering the common cases (merge conflict, fresh PR, open threads, false positive, already-fixed). | 5 / 5 |
Workflow Clarity | Clear multi-step sequence with explicit validation checkpoints and feedback loops: check-state-before-acting, conflict-first ordering, sync check before every push, post-push verify after every push, re-trigger/wait/loop, and explicit stop conditions gated by the definition-of-clean contract. | 5 / 5 |
Progressive Disclosure | Self-contained single file with clear `##` sections (When to use, Inputs, Definition of clean, Loop, Reporting, Hard rules), easy navigation, and one-level-deep references to the sibling `/ship` skill that are clearly signaled rather than nested. | 5 / 5 |
Total | 19 / 20 Passed |