Content
77%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
Highly actionable with a clearly sequenced, checkpointed workflow, but the body is verbose and monolithic — redundant inbox-peek warnings and an upstream patch inflate the token budget, and there is no progressive disclosure via separate reference files.
Suggestions
Consolidate the three separate inbox-peek-is-unreliable warnings (Known Failure Modes #2, the 'CRITICAL: Inbox Peek Is Unreliable' section, and the Anti-Patterns bullet) into one authoritative section to cut redundancy.
Move the 'Known upstream issues' Hermes source patch and the full command-reference tables into a reference file (e.g. references/commands.md) and link to it from the body, improving both conciseness and progressive disclosure.
Trim the per-flag explanatory notes in 'How The Hermes Adapter Builds Commands' to the essentials Claude needs to invoke the tool correctly.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly actionable but padded: the inbox-peek-is-unreliable warning is repeated across three sections, and the 'Known upstream issues' section embeds a Hermes source-code patch that is beyond what Claude needs to use the skill. | 2 / 3 |
Actionability | Provides copy-paste-ready bash blocks for launch, spawn, board polling, and tmux capture-pane, plus concrete command-reference tables — fully executable guidance. | 3 / 3 |
Workflow Clarity | The polling pattern is clearly sequenced (sleep 60, tick loop, board check, inbox read, cleanup) with explicit checkpoints ('NEVER check inboxes within the first 60 seconds', 'Clean up ONLY after reading reports') and an error-recovery branch. | 3 / 3 |
Progressive Disclosure | No bundle files exist, yet the body is a monolithic 200+ line file with the command reference tables and upstream-issues patch inline — content that would benefit from being split into referenced files. | 2 / 3 |
Total | 10 / 12 Passed |