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 strong, expert-grade operating manual: it teaches the discovery-not-memorize contract, the serial-call discipline, plain-English-to-scene translation, and explicit verification with checklists, while offloading bulk detail to five well-signaled, real reference files. The only real weaknesses are mild redundancy across sections and the absence of a single inline worked `call_tool` example, both minor. Combined with a frontmatter description that undersells the same skill, the content is markedly stronger than its own routing metadata.
Suggestions
De-duplicate the one-call-at-a-time rule: state it once in the Operating Loop and let the Pitfalls section point back to it rather than restating it twice.
Include one short inline example of a complete `call_tool` payload (toolset_name + short tool_name + arguments) in the Tool Surface section so the dispatch shape is visible without opening recipes.md.
Trim second-person art-direction asides that repeat guidance already in the verification steps (e.g. restating screenshot review in both step 5 and step 4 of the scene plan).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with genuinely non-obvious, environment-specific facts (AllToolsets vs. Unreal MCP plugin split, serial game-thread execution, tool-search mode, label vs. name, lux/Kelvin calibration) and never explains concepts Claude already knows. It is not score 5 because a few rules are stated redundantly across sections (the one-call-at-a-time rule appears in Operating Loop #2, #3, and again in Pitfalls; "save often" advice repeats) and a few sentences could be trimmed. It is not score 3 because there is no padded or unnecessary explanation block. | 4 / 5 |
Actionability | Highly concrete: exact menu paths ("Edit > Plugins", "Editor Preferences > General > Model Context Protocol"), copy-paste commands (`hermes mcp install unreal-engine`, `ModelContextProtocol.StartServer`, `ModelContextProtocol.RefreshTools`), exact tool names (`mcp_unreal_engine_list_toolsets`), config keys and paths (`mcp_servers.unreal-engine.timeout` in `~/.hermes/config.yaml`). It is not score 5 because no inline example of a complete `call_tool` invocation with an argument payload is shown — that shape is deferred to `references/recipes.md`. It is not score 3 because everything given is directly executable, not pseudocode or high-level hints. | 4 / 5 |
Workflow Clarity | The 7-step Operating Loop and the 5-step "From Plain English to a Scene" plan are explicitly sequenced, with validation woven in ("Read every result", read-back after property writes, re-query + screenshot at each milestone) plus a dedicated Verification Checklist and concrete error-recovery branches (missing tools = wrong start order; hung call = modal dialog; timeout = raise config timeout). This matches the anchor-5 example's validate → fix → retry structure with a checklist for the complex process; batch/destructive operations are explicitly guarded by save-before-and-after rules. | 5 / 5 |
Progressive Disclosure | SKILL.md is a genuine overview (~240 lines of rules and loop) with a Reference Files table describing each of the five reference files, plus targeted inline pointers at the exact point of need ("references/scene-craft.md has the numbers", "references/advanced-workflows.md" for batching). All five referenced files exist, are one level deep, and their contents match the table's descriptions. It is not score 4 because there is no organization gap — navigation is easy and every split is appropriate. | 5 / 5 |
Total | 18 / 20 Passed |