Content
85%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 a well-structured, highly actionable overview that assumes Claude's competence and pushes detail into five clearly signaled, real reference files. Its workflows include explicit validation, feedback loops, and a checklist; the only weaknesses are minor verbosity in the summary pitfalls and the fact that complete call sequences live in recipes.md rather than inline.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational — e.g. "Units are centimeters; axes are Z-up, X-forward", "hermes mcp install unreal-engine", "Default bind is http://127.0.0.1:8000/mcp" — with no padding about concepts Claude already knows. It is not a 5 because the "top of mind" pitfalls section partially duplicates references/pitfalls.md and passages like the licensing note could be trimmed. | 4 / 5 |
Actionability | Concrete, executable guidance throughout: exact commands ("ModelContextProtocol.StartServer", "ModelContextProtocol.RefreshTools"), config paths ("~/.hermes/config.yaml" under "mcp_servers.unreal-engine"), and qualified toolset names. It is not a 5 because the full copy-paste call sequences for common builds are deferred to references/recipes.md rather than appearing inline in the body. | 4 / 5 |
Workflow Clarity | The seven-step Operating Loop is clearly sequenced with explicit validation checkpoints ("Inspect first", "Read every result", "Verify visually and structurally", "Save often"), feedback loops (read values back, fix before moving on), and a closing Verification Checklist. Destructive/non-undoable editor edits are explicitly guarded, so the batch/destructive cap does not apply. | 5 / 5 |
Progressive Disclosure | SKILL.md is a clear overview with a Reference Files table signaling five one-level-deep files (tool-surface.md, advanced-workflows.md, scene-craft.md, recipes.md, pitfalls.md), all of which exist in ./references/. Content is appropriately split — overview and rules inline, catalogs/recipes/cheat-sheets in references — with easy navigation and no nested references. | 5 / 5 |
Total | 18 / 20 Passed |