Content
56%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 well-organized and domain-specific with a clear single-action workflow and thoughtful troubleshooting, but it is padded: the full JSON schema duplicates the input table, a caveat is repeated three times, and the main invocation example uses placeholder values instead of an executable worked example.
Suggestions
Replace the "string_value" placeholders with one fully-filled, copy-paste-ready example (e.g. a real gameObjectRef, isolated, backgroundMode, cameraView, and lights values) so the How to Call section is executable.
Move the full Input JSON Schema into a references/ file (e.g. references/schema.json) and keep only the Input table plus a one-line pointer, removing the duplication.
State the OnEnable side-effect caveat once (in the Side-effect caveat section) and drop its repetition from the opening paragraph to save tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Sections like Camera views, Background modes, and Lights are tight and useful, but the ~110-line inline JSON schema largely duplicates the Input table, and the OnEnable side-effect caveat is stated three times (description, opening paragraph, dedicated section). Mostly efficient with clear redundancy that could be trimmed — matches anchor 3, not 4 where only minor trimming would be needed. | 3 / 5 |
Actionability | The CLI invocation and the lights JSON example are concrete, but the primary call example fills every parameter with the placeholder "string_value" (including booleans and numbers), making it a template rather than executable code, and no filled real-world example is given. Some concrete guidance but incomplete/pseudocode-like, matching anchor 3 rather than 4's "concrete code with minor gaps". | 3 / 5 |
Workflow Clarity | This is a single-action tool skill and the workflow (run unity-mcp-cli with the input, or --input-file/stdin for complex payloads) is unambiguous in structure, with a troubleshooting path for CLI-not-found. Minor gaps (placeholder values instead of a worked example, no step to verify the returned image) keep it at anchor 4 rather than 5. | 4 / 5 |
Progressive Disclosure | No bundle files exist and the document has a sensible header structure, but the full JSON Schema (~110 lines) is reference material inlined into SKILL.md that belongs in a separate reference file, duplicating the Input table. Structure present with content that should be separate inlined — anchor 3 rather than 4's "most content appropriately placed". | 3 / 5 |
Total | 13 / 20 Passed |