Content
63%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, mostly actionable tool reference with good error-recovery documentation, but it is held back by triple-documented parameters and two large raw JSON schemas inlined in the main file. Moving the schemas to reference files and consolidating the parameter documentation would materially improve both conciseness and progressive disclosure.
Suggestions
Move the Input and Output JSON schemas to a references/ file (e.g. references/schemas.md) and keep only a short summary of the response shape inline; the full .NET-named $defs dump is the single largest source of bloat.
Consolidate the Filters/Response toggles prose with the Input table — one canonical parameter listing instead of three overlapping enumerations.
Replace the "string_value" placeholder example with one fully-real invocation (e.g. a PlayMode run filtered to one test class) so the example is directly copy-paste executable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body documents the same 11 parameters three times — prose in "Filters"/"Response toggles", the Input table, and the Input JSON Schema — and then dumps a ~140-line raw output JSON schema with .NET type names like "System.Collections.Generic.List(com.IvanMurzak.Unity.MCP.Editor.API.TestRunner.TestLogEntry)". Most content is information-bearing (not concept re-explanation), so it clears score 2, but the redundancy and inline schema bloat mean it could be tightened considerably. | 3 / 5 |
Actionability | "unity-mcp-cli run-tool tests-run --input ..." plus the --input-file and stdin heredoc forms give a mostly executable, copy-paste-ready invocation, and the Input table supplies concrete example values. The gap keeping it from 5: the primary example uses placeholders ("string_value", bare booleans) rather than one fully-real call, e.g. a real EditMode run filtered to a test class. | 4 / 5 |
Workflow Clarity | For a single-tool skill the action is unambiguous, and failure/recovery paths are documented: "If any open scene is dirty... save them and retry", "Pre-existing compilation errors short-circuit the run... so the caller can fix the project first", the domain-reload Processing/resume flow, and CLI-not-found fallbacks (npm install -g / npx). Minor gaps keep it at 4: these checkpoints are scattered across sections rather than sequenced, and there is no explicit verify step for confirming tests actually ran post-reload. | 4 / 5 |
Progressive Disclosure | Section structure is clear (Filters, Response toggles, Domain reloads, How to Call, Input, Output) and the /unity-initial-setup reference is one level deep, but ~160 lines of raw input/output JSON schemas are inlined in SKILL.md — content that clearly belongs in reference files given no bundle directory exists. This matches the anchor "some structure but... content that should be separate is inline" rather than 2, since structure and navigation are otherwise good. | 3 / 5 |
Total | 14 / 20 Passed |