Content
75%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.
A lean, highly actionable, well-gated instruction skill: concrete templates, explicit stop-conditions before every risky step, and an appropriate one-level-deep reference to assets/fan-out-pool.md. Weaknesses are mild — repeated rules that could be consolidated, no retry/recovery path for failed worker slots, and a couple of inlined sections that belong in a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense rule-only prose with no explanation of concepts Claude already knows — cards and tables are templates, not exposition. However, several rules repeat 3-4 times ("does not triage/review PRs" in the intro, Selector, Selection, and Hard nos; "one issue per slot" and "FANOUT_LIMIT is concurrency, not queue length" each stated twice; "do not dispatch an unaccepted issue" twice), which is trimming material. Anchor 4, not 5, because of that redundancy. | 4 / 5 |
Actionability | Copy-paste-ready Enter card, Exit receipt, and queue-table templates with exact columns and field semantics; a concrete command hint ("`gh issue list` on `status/accepted`"); exact worker session-name format. Minor gaps keep it at anchor 4: "Probe worker-code on disk" and "Resolve ORIGIN" give no concrete command or probe to run. | 4 / 5 |
Workflow Clarity | A batch operation with explicit fail-closed validation checkpoints at every pre-spawn step ("Missing field -> stop", "Missing table, missing column, or blank rationale -> stop. Do not spawn.", "write: on -> stop", existing-PR check, dedup, assignment check) plus a mandatory final report — so the batch-validation cap at 3 does not apply. Anchor 4 rather than 5 because there is no post-dispatch verification or error-recovery loop (no instruction for what to do when a worker slot returns having failed). | 4 / 5 |
Progressive Disclosure | One clearly-signaled, one-level-deep reference — "[assets/fan-out-pool.md](assets/fan-out-pool.md)" under "## Fan-out", and the file exists with non-duplicative detail — and sections are well organized. Anchor 4 rather than 5 because the ~180-line body inlines material that could be split out (the detailed skip-rule list, and the worker-contract "Ownership writes" block that describes worker rather than scheduler behavior). | 4 / 5 |
Total | 16 / 20 Passed |