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.
The content is an exemplary orchestration skill: a clearly sequenced six-step loop with copy-paste-ready commands, explicit validation gates, feedback loops for rejected candidates, and well-signaled one-level-deep references that all exist in the bundle. The only weakness is mild redundancy — the dev/test leakage warning is repeated across sections and the citation guidance is verbose.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and procedural with no explanations of concepts Claude already knows, but the dev/test overfitting caveat is repeated in three places ('It must not be used as a search oracle — that's the whole point', 'Repeated merge decisions on the same held-out set...', 'Dev guides, test admits') and the citation section is verbose — minor over-explanation that could be trimmed, matching anchor 4 rather than anchor 5's every-token-earns-its-place. | 4 / 5 |
Actionability | Every loop step has copy-paste-ready commands with realistic flags ('python "$ARBOR_TREE" init --objective ... --dev-eval ... --test-eval ...', 'add-node --parent n0 --hypothesis "..."', 'set-evidence --node n2 --dev-score 70.0 ...', 'merge --node n2 --test-score 67.67 --branch-ref "wt/n2"') plus an explicit four-field executor return contract (dev_score, result, insight, branch_ref). Fully executable guidance covering the common cases. | 5 / 5 |
Workflow Clarity | The six-step coordinator loop (Observe, Ideate, Select, Dispatch, Backpropagate, Decide) is clearly sequenced with explicit validation checkpoints: the merge gate 'refuses an unscored baseline and non-finite scores', the test evaluator runs 'on the exact candidate commit in a fresh worktree', and gate rejection is treated as a feedback loop ('Record that lesson; don't quietly promote it anyway'). Protocols are frozen before search. | 5 / 5 |
Progressive Disclosure | All four referenced files (references/htr-methodology.md, references/executor-brief.md, references/report-template.md, references/arbor-upstream.md) exist in the bundle, are one level deep, and each is listed with its purpose and when to read it ('Read when you want the rationale behind a design choice'). The main body appropriately holds the orchestration loop while rationale, templates, and the upstream CLI guide live in references. | 5 / 5 |
Total | 19 / 20 Passed |