Content
81%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 highly actionable with copy-paste-ready CLI commands, explicit preconditions, error behavior, and the discard-changes consequence of save=false, making the single-action workflow unambiguous. Its main weakness is redundancy: the one-boolean input is documented in three places and the output in two, plus generic CLI boilerplate that could be trimmed.
Suggestions
Consolidate the `save` parameter into a single representation: drop either the "## Inputs" bullet section or the "## Input" table, keeping the JSON Schema only if it adds information beyond the prose.
Trim the generic "For complex input" quote block and Troubleshooting section to a one-line pointer, since they are boilerplate not specific to this tool.
Shorten the Output section by referencing the AssetObjectRef definition once instead of repeating its full description text in both the property and the $defs entry.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The single `save` boolean parameter is documented three times ("## Inputs" bullet, "## Input" table, and the Input JSON Schema), and the output is described twice ("## Behavior" and the Output JSON Schema), fitting the 'mostly efficient but includes some unnecessary explanation or could be tightened' anchor. It is below 4 because this duplication is a real redundancy, not just a minor trim. | 3 / 5 |
Actionability | The body provides a fully executable, copy-paste-ready CLI invocation with a concrete example value ("save": false) plus stdin and --input-file variants, and an install fallback (npx unity-mcp-cli), matching the 'fully executable; copy-paste ready code or commands' anchor. It is not 4 because the examples already cover the common cases including error recovery for a missing CLI. | 5 / 5 |
Workflow Clarity | This is a simple single-action skill and the action is unambiguous: it names the prerequisite (open the prefab first with 'assets-prefab-open'), the error condition ("Throws when no prefab stage is currently open"), and the destructive-path consequence ("unsaved changes are discarded when `save` is `false`"). Per the simple-skill exception the single action with explicit validation of preconditions and consequences scores 5. | 5 / 5 |
Progressive Disclosure | Sections are clearly headed and well-organized with no nested references and no orphaned bundle paths (no references/scripts/assets directories exist), fitting the 'good structure; most content appropriately placed; references mostly clear' anchor. It is not 5 because the body exceeds 50 lines and inlines generic CLI-invocation boilerplate and troubleshooting that is not specific to this skill. | 4 / 5 |
Total | 17 / 20 Passed |