Content
40%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 rich in accurate, project-specific detail with genuinely actionable commands, tables, and pitfalls, but it is a monolithic A-Z encyclopedia rather than a skill overview. It is padded with a table of contents, a duplicate feature summary, and dated release history, has no sequenced workflow with validation checkpoints, and pushes all detail inline instead of splitting it into referenced files.
Suggestions
Split the body into one-level-deep reference files (e.g. RELEASES.md for the changelog, CONFIG.md for the configuration reference, ARCHITECTURE.md for sections 5-9) and keep SKILL.md as a concise overview with clearly signaled links.
Delete the 55-line Table of Contents and the Key Features Summary table that duplicates the Project Overview; move the dated Release History out of the always-loaded body since time-sensitive version/date detail does not belong there.
Add explicit validation checkpoints to the operational sequences (e.g. after install: verify `hermes --version` and API-key connectivity before proceeding; for plugin/skill authoring: run the test suite with `_isolate_hermes_home` before shipping).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is 1765 lines with a ~55-line table of contents, a "Key Features Summary" table that largely duplicates the Project Overview bullets, and a six-version Release History changelog full of specific dates and version numbers ("v0.2.0 (March 12, 2026)") that is time-sensitive and not placed in a deprecated/old-patterns section. This matches anchor 2 (noticeably verbose, several padded sections) — not 1 because the material is project-specific knowledge Claude would not already know, and not 3 because the padding (TOC, changelog, duplicate summary) is substantial rather than incidental. | 2 / 5 |
Actionability | There is a large amount of concrete, executable material: copy-paste install commands ("curl -fsSL https://raw.githubusercontent.com/... | bash", "hermes model"), exact file paths, environment-variable and config-file tables, a plugin interface code block, and highly specific pitfalls ("DO NOT hardcode `~/.hermes` paths — Use `get_hermes_home()`"). It falls short of anchor 5 because some code is illustrative or truncated ("# ... plus provider, routing, callback params", a simplified agent loop, and interface stubs like `def store(key, value)` without bodies), leaving minor gaps. | 4 / 5 |
Workflow Clarity | Apart from the Installation section's rough command sequence, the document is 26 topic-ordered encyclopedia sections rather than a sequenced workflow, and there are no validation or verification checkpoints anywhere for operations that are destructive or batch-capable (terminal execution, file manipulation, supply-chain-sensitive installs). This fits anchor 2 (rough sequence present but many gaps, validation absent) — the install steps keep it above 1, but the absence of any validate-and-retry loop and the non-procedural organization keep it well below 3. | 2 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent) and the body inlines content that clearly belongs in separate files — a full changelog, a configuration reference, per-subsystem deep-dives, and a project-structure listing — all in one monolithic 1765-line SKILL.md. This matches anchor 2 (minimal bundle structure; content that clearly belongs in separate files is inlined); the internal headers and TOC give some navigation, but there are no one-level-deep reference files at all, so it cannot reach 3's "references present" bar. | 2 / 5 |
Total | 10 / 20 Passed |