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 provides fully executable CLI guidance with useful troubleshooting and explicit parameter semantics, and it stays lean in prose. Its main weaknesses are redundancy (duplicated intro and thrice-repeated path syntax) and inlining of the two full JSON schemas that would be better placed in reference files.
Suggestions
Replace the placeholder values in the 'How to Call' example with a realistic worked example (e.g., an actual assetRef, a paths array, and a viewQuery) so it is copy-paste runnable.
Move the Input/Output JSON schemas into references/ files (e.g., references/input-schema.md and references/output-schema.md) and keep only the parameter table inline, reducing SKILL.md to an overview.
Remove the duplicated intro sentence and state the path syntax once (in the 'Path syntax' section), dropping it from the input table row.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The prose is lean and assumes Claude's competence (no explaining what Unity or JSON is), but the intro paragraph repeats the frontmatter description almost verbatim, path syntax is stated three times (dedicated section, input table, and again in ViewQuery schema descriptions), and ~130 lines of JSON schemas are inlined. Matches 'mostly efficient but includes some unnecessary explanation or could be tightened'. | 3 / 5 |
Actionability | Concrete, runnable CLI commands are given (run-tool with --input, --input-file, and stdin heredoc variants) plus troubleshooting for a missing binary. Not 5 because the example uses placeholder "string_value" for every parameter instead of a realistic worked example with actual values. | 4 / 5 |
Workflow Clarity | This is a single-tool, read-only skill: the prerequisite (find the asset with 'assets-find' first) and the single call are unambiguous, and the mutually-exclusive paths/viewQuery options are explicitly stated, so no validation checkpoint is needed for a non-destructive read. Minor gap: no end-to-end example with real values showing the find-then-read flow. | 4 / 5 |
Progressive Disclosure | The single SKILL.md is well-sectioned with clear headers, but there are no bundle files (no references/, scripts/, or assets/ directories) and the two large JSON schemas (~130 lines combined) are inlined rather than split into reference files. At ~190 lines this exceeds the under-50-line simple-skill exception, matching 'some structure but content that should be separate is inline'. | 3 / 5 |
Total | 14 / 20 Passed |