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.
A well-engineered operational skill: nearly every line is machine-specific knowledge Claude cannot infer, commands are copy-paste executable, destructive operations are fenced with staged validation and feedback loops, and detail is properly offloaded to real one-level-deep references and helper scripts. The only weakness is slight redundancy (re-stated ID-parsing rule, an intro that repeats the description's coverage list).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and machine-specific throughout — binary resolution order, the client/server RAM behavior, the 'session stop can report a 15s timeout even though the stop landed' caveat, and geometry rules are things Claude cannot know. It never explains general concepts. It falls just short of the 5 anchor because of minor trimmable redundancy: the opening paragraph re-enumerates coverage already in the description, and the 'parse IDs from JSON, never predict/construct them' rule is stated three times (Locate the binary, Discovering state, Safety rules) — deliberate emphasis, but the 4 anchor ('minor instances of over-explanation that could be trimmed') fits better than 5's 'every token earns its place'. | 4 / 5 |
Actionability | Guidance is fully executable and copy-paste ready: real PowerShell invocations with exact flags and values ("& $herdr pane split w1:p1 --direction right --ratio 0.5 --no-focus", "& $herdr wait output w1:p2 --match "test result" --timeout 120000"), exact script usage lines ("pwsh -File scripts/herdr-cleanup.ps1 -DryRun"), and concrete error-recovery commands. This matches the 5 anchor: specific commands cover the common cases, well beyond the 4 anchor's 'minor gaps'. | 5 / 5 |
Workflow Clarity | Sequences are explicit with validation checkpoints exactly where risk lives: cleanup is staged as DryRun inventory → graceful stop → force-kill with an agent-detection backstop that refuses without -Force; agent driving is launch → wait idle → submit → wait done; and error-recovery feedback loops are stated (re-check the process list before concluding 'session stop' failed; 'Inspect before waiting' because wait output can false-match scrollback). Because the destructive/batch operations here DO have explicit validation, the workflow-clarity cap of 3 does not apply; this matches the 5 anchor (clear sequence, explicit validation, feedback loops for error recovery), not the 4 anchor's 'minor validation gaps'. | 5 / 5 |
Progressive Disclosure | Verified against the actual bundle: the ~160-line body is an overview plus the most-used commands, with bulk CLI syntax split to references/cli-reference.md and agent-driving lore split to references/orchestration-playbook.md — both real files, one level deep (the playbook's .md mentions are user task files, not nested skill references). Fiddly Win32 parts are factored into scripts/herdr-window.ps1 and scripts/herdr-cleanup.ps1 with usage documented inline. References are clearly signaled with purpose and read-conditions ("Read it before driving more than one agent"), matching the 5 anchor: clear overview, well-signaled one-level-deep references, easy navigation. | 5 / 5 |
Total | 19 / 20 Passed |