Content
71%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 body is exceptionally actionable — exact commands, paths, URLs, and flags for every operation — with a clear ordered workflow and real validation gates. Its weaknesses are structural: a ~47-line MUST recap that duplicates the sections, a cluttered step 10, and no offloading of detailed material (routine-copy provenance rules, post-save login operations) into reference files.
Suggestions
Delete or drastically prune the trailing MUST block — it restates rules already covered in the Loop-able, Pocket, Fixed step, Gate, and Routine copy sections, cutting roughly 45 lines of duplication.
Split the detailed operational rules into a one-level-deep reference file (e.g., references/routine-copy.md for provenance/origin rules and references/harness-ops.md for the step-10 login/apply/post-save commands), keeping SKILL.md as a lean overview plus the Order sequence.
Restructure the post-save operations currently jammed into Order step 10 into their own flat 'After save' section with a consistent sub-list, so login, apply, show/logs/rm, and model-change guidance are not nested under one numbered step.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is telegraphic with zero concept-explanation filler, but the final ~47-line MUST block (lines 178-224) almost entirely restates rules already stated in the sections ('Do not invent a catalog' appears three times, 'The teammate can skip' twice). Mostly efficient, but the duplicate recap section could be cut. | 3 / 5 |
Actionability | Fully executable, copy-paste-ready commands throughout: `hermes config get delegation.subagent_auto_approve`, `hermes mcp add scalekit --url <mcp-url> --auth oauth`, the complete `dora harness new --accept --yes …` invocation with every flag, and the official install URL. | 5 / 5 |
Workflow Clarity | The 'Order' section gives a numbered 10-step sequence with explicit validation gates (loop-able check, pocket check, one-pass before freeze, spec check, gate before save, 'Do not fake a pass') and a retry loop ('Another one-pass is allowed'). Step 10 is a sprawling nested blob mixing apply/boot/login/post-save operations with inconsistent indentation, holding it below 5. | 4 / 5 |
Progressive Disclosure | No bundle files exist and all ~225 lines of dense operational detail live inline in SKILL.md with clear section headers — well-navigable, but this is the full operational manual rather than an overview pointing to one-level-deep reference files. Matches the '200 lines that could be in a separate file' pattern with good headers. | 3 / 5 |
Total | 15 / 20 Passed |