Content
96%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 tight operational skill: executable commands covering every common invocation pattern, explicit pre-send validation and error-recovery loops for a batch operation, and dense prose with no padding. The single structural improvement would be moving the parameter reference and identity-validation internals into a bundled reference file so SKILL.md stays a pure overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section is operationally dense with zero padding: nothing explains concepts Claude already knows — no SSH tutorial, no PowerShell basics — and each line carries skill-specific facts ("every remote touch a ~258 ms SSH call", "-MaxTypedChars, default 4096", "Timeout ⇒ timedout-unknown — the remote command may still be running; it is NEVER auto-retried"). This matches the level-5 anchor (lean, assumes competence, every token earns its place); level 4 would require identifiable over-explanation to trim, and none is evident. | 5 / 5 |
Actionability | Five ready-to-run invocations in 'How to run' cover the common cases — broadcast ("& $connect -WorkspaceName fanout-... -Command 'git pull; npm test' -Wait"), per-pane (-Commands array), REPL steering (-Profile RawInteractive), subset (-PaneIndex (0..3)), and sentinel-driven agent tasks — plus executable Pester and smoke-test commands. Placeholders like "<...>\__solutions\" are environment-specific values equivalent to the anchor's "file.pdf", so this fits the level-5 anchor (copy-paste-ready commands covering common cases) rather than level 4's 'minor gaps'. | 5 / 5 |
Workflow Clarity | The lifecycle is explicitly sequenced ("cmux-fanout (build grid + map) → cmux-connector (inject / administer) → cmux-fanout teardown.ps1"), and this batch operation has thorough validation: pre-send identity validation ("the live tree must contain every manifest surface with NO extras"), fail-before-send on unknown indices, and a documented status taxonomy with failure modes ("failed | timedout-unknown | ..."). Explicit feedback loops are present — the context-limit recovery loop ("send /clear, wait for -ReadyPattern ... re-send ONCE") and the CMUX_SHAPE drift procedure ("run fanout's tests\smoke\03-discovery.ps1 and fix ONLY the key list") — matching the level-5 anchor; the batch-operation cap of 3 does not apply since validation is extensive. | 5 / 5 |
Progressive Disclosure | No bundle reference files exist (no references/, scripts/, or assets/ directories), and the body is well sectioned (Prerequisites, How to run, profiles table, Key parameters, Results, gotchas, Tests, Cleanup) with clearly signaled one-level references ("../cmux-fanout/setup.md", the smoke-test paths). It falls at level 4 rather than 5 because reference-grade detail — the full parameter semantics in 'Key parameters' and the identity-validation internals — is inlined in SKILL.md where a skill of this complexity would ideally split it into a separate reference file, leaving only an overview plus pointers. | 4 / 5 |
Total | 19 / 20 Passed |