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 exceptionally disciplined orchestration skill: concrete commands and machine-checkable conditions throughout, a fully sequenced tick with validation and error-recovery loops, and textbook progressive disclosure — a lean overview whose every reference target exists and is signaled at point of use. The only cost of its compression is minor rule duplication across the boundaries and steps, which keeps conciseness just short of the top anchor.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is extremely dense with project-specific, non-obvious rules and explains nothing Claude already knows (no gh/GitHub/CI basics), assuming full competence. It sits between anchors 4 and 5: nearly every token encodes a real rule, but the snapshot-is-the-only-authority principle is stated three times across the overview and boundaries (lines 13, 26, 27) and a few boundary rules are restated in the steps, so minor consolidation is possible — fitting anchor 4 (efficient, minor trimming possible) more than anchor 5's 'every token earns its place'. | 4 / 5 |
Actionability | Guidance is concrete and copy-paste-ready: exact commands (`gh pr checkout <ref>`, `gh run rerun <run-id> --failed -R <host>/<owner>/<repo>`, `gh stack merge` + `gh stack sync`), exact delegate invocations (`ce-resolve-pr-feedback mode:pipeline`, `ce-debug mode:pipeline`), and exact machine-readable conditions (`manager_status == "confirmed"`, `open_needs_human == 0`, `branch_currency_blocker == null`). This matches anchor 5 for an instruction-only skill: fully executable commands covering the common cases, far above anchor 4's 'minor gaps'. | 5 / 5 |
Workflow Clarity | The four-step process is explicitly sequenced with an ordering invariant inside each tick, and validation checkpoints are exhaustive: every arming step has a stop path (repo check, PR resolution, checkout/push access), the tick opens with a terminal check, stale-SHA cancellation invalidates dead CI, and defect states (`unrequested_base_merge`, red residuals) are reported rather than silently dropped. Feedback loops for error recovery (flaky → rerun, real failure → ce-debug, unfixed → tracked residuals) match anchor 5; the destructive-operation validation cap is satisfied by the atomic claim, `expected_head_sha`, and defect-reporting steps. | 5 / 5 |
Progressive Disclosure | Scored against the actual bundle: every `references/*.md` path cited in the body exists on disk, the single script (`scripts/pr-snapshot`) is real, and references are one level deep (`stack.md`/`watch-loop.md` reach `stack-commands.md`, no deeper nesting). The body is a lean ~60-line overview that signals each per-topic file exactly at its point of use (branch-currency.md at the currency step, settle.md at stop conditions, tick.md before first snapshot), matching anchor 5's clear overview with well-signaled one-level-deep references and easy navigation. | 5 / 5 |
Total | 19 / 20 Passed |