Content
65%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A dense, well-structured, and highly actionable reference for Honcho+Hermes configuration, but it is overlong for a SKILL.md overview with notable internal redundancy and no progressive disclosure into separate bundle files.
Suggestions
Consolidate the dialectic cadence/depth/level coverage into one place and have the 'Config Reference' table link to it, eliminating the verbatim repetition.
Move the full Config Reference and CLI Commands tables into a separate reference file (e.g. CONFIG.md) and keep SKILL.md as an overview, improving progressive disclosure and token economy.
Add an explicit validate->fix->retry loop for destructive operations such as conclusion deletion (e.g. verify the deletion via honcho_search/honcho_context afterward).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~415-line body is mostly efficient and free of concepts Claude already knows, but the dialectic cadence/depth/level material is repeated verbatim across 'Three Orthogonal Knobs' and the 'Config Reference' tables, and the recall/observation/session tables are restated, adding avoidable length. | 2 / 3 |
Actionability | Concrete, copy-paste-ready commands ('hermes profile create coder --clone', 'hermes honcho status'), executable JSON config blocks, and specific tool-call examples with parameters make the guidance fully actionable. | 3 / 3 |
Workflow Clarity | Sequences are clear (Setup with a Verify step, the 3-step 'On conversation start' flow, when-to-call decision trees) and Troubleshooting aids recovery, but there are no explicit validate->fix->retry feedback loops for destructive operations such as honcho_conclude delete_id PII removal. | 2 / 3 |
Progressive Disclosure | Sections and tables are well organized, but the body is a ~415-line monolithic file with no bundle files and only external URL references; the Config Reference and CLI command tables that could live in separate reference files are inlined. | 2 / 3 |
Total | 9 / 12 Passed |