Content
70%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 exceptionally actionable, well-validated operational loop whose body is undermined by heavy internal repetition and a monolithic structure. The command-level guidance and validation checkpoints are top-tier, but the same rules are maintained in multiple places and 500 lines of policy are inlined with no reference files to split them.
Suggestions
Deduplicate the push-target/remote-verification rules into one canonical section (currently stated in the intro, 'For an existing PR update', Setup, and 'Each tick') and reference it instead of restating it.
Split rarely-needed detail — the missing-changeset special case, the latest-feedback handoff ledger rules, and the post-merge /ship continuation — into references/ files linked from SKILL.md.
Consolidate the clock/stop rules (30-minute quiet-green, 10-minute soak, mode endpoints) into a single table or section; they currently appear in at least four places.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The push-target and remote-verification rules are restated roughly four times (intro paragraph, 'For an existing PR update', Setup item 2, and 'Each tick'), and the 'never rebase/force-push', clock-reset, and stop-condition rules each recur across multiple sections — substantial duplication rather than isolated tightening opportunities. Every individual rule is nontrivial domain policy rather than general knowledge, but the repetition is padded verbosity. | 2 / 5 |
Actionability | Fully executable throughout: exact gh/git commands, working jq pipelines for reply-state comment coverage, a complete changeset file template with slug examples, and the guarded merge command with --match-head-commit. Copy-paste ready commands cover the common cases. | 5 / 5 |
Workflow Clarity | The tick sequence is explicit (Step 0 status → Step 1 conflicts → feedback → CI → merge gate) with abundant validation: live OID rechecks before every push, the five simultaneous merge conditions, full gate revalidation pre-merge, and dual final audits. Feedback loops for conflict and non-fast-forward recovery, soak-timer resets, and a merge checklist are all present. | 5 / 5 |
Progressive Disclosure | No bundle files exist; ~500 lines of dense policy are inlined in SKILL.md. Section headers give it structure, but content that clearly belongs in separate files (changeset special case, latest-feedback handoff ledger rules, post-merge /ship continuation) is inline, and there are no one-level-deep references. | 3 / 5 |
Total | 15 / 20 Passed |