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 actionable and the single-step workflow is clear with a stated verification follow-up, but it is held back by duplicated parameter documentation and a large inlined API schema. Merging the two input sections and moving schemas to a reference file would lift both conciseness and structure.
Suggestions
Merge the "## Inputs" prose section and the "## Input" table into one section to remove the duplicated parameter documentation.
Move the input/output JSON schemas to a references/ file (e.g., references/schemas.md) and keep only the essential fields inline.
Replace the "string_value" placeholders in the example with a realistic filled-in call, e.g., a path like "Assets/Scenes/Main.unity".
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The "## Inputs" prose section and the later "## Input" table document the same three parameters twice, the scene-list-opened suggestion repeats the frontmatter description verbatim, and the output schema carries long Unity-doc text (e.g., the IsValidScene explanation). The CLI/schema content itself is efficient, so this is mostly efficient with clear tightening opportunities rather than severely padded. | 3 / 5 |
Actionability | "unity-mcp-cli run-tool scene-create --input '{...}'" plus the --input-file and stdin variants and the npx troubleshooting note are concrete and executable. It stops short of 5 because the example uses "string_value" placeholders instead of a realistic filled-in call, so it is not literally copy-paste ready. | 4 / 5 |
Workflow Clarity | The single action is unambiguous: Behavior states it calls EditorSceneManager.NewScene + SaveScene on the main thread and returns SceneDataShallow, and a post-call verification step is stated ("Use 'scene-list-opened' to inspect the resulting opened-scene set afterwards"). Not a destructive or batch operation, so no validation cap applies; it misses 5 only because no guidance covers failure handling (e.g., invalid path or existing scene). | 4 / 5 |
Progressive Disclosure | Sections are clearly headed (Inputs, Behavior, How to Call, Troubleshooting, Input, Output), but no bundle files exist and roughly 90 lines of input/output JSON schemas are inlined in the body — reference material that would sit better in a separate file. The skill is over 50 lines, so the small-skill exception for a 5 does not apply. | 3 / 5 |
Total | 14 / 20 Passed |