Content
88%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.
A high-quality, highly actionable reference: copy-paste commands with defaults and exact error messages, a validated inspect→optimize→validate pipeline with ordering rules, and mistake/fix pairs. The two weaker spots are the duplicated generic three.js boilerplate in Quick Start and the absence of any reference-file split for the more peripheral sections.
Suggestions
Trim the Quick Start code block to the loader wiring plus a one-line note that PBR materials need lights, dropping the generic renderer/scene/camera/animation-loop setup that the skill otherwise assumes Claude knows.
Consider moving peripheral sections (WebGPU/TSL, gltfjsx/React, Common Mistakes) into references/ files linked from a short overview, keeping SKILL.md focused on the core inspect/optimize/load pipeline.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes competence — no concept tutorials, every paragraph carries non-obvious specifics (flag defaults, ordering rules, deprecation releases). However, the Quick Start inlines ~20 lines of generic three.js boilerplate (renderer, scene, lights, camera, animation loop) that Claude already knows and that the later "Loader Setup" section repeats in minimal form — efficient with minor instances of over-explanation that could be trimmed (anchor 4). | 4 / 5 |
Actionability | Every command and code block is fully executable and copy-paste ready — e.g. "npx @gltf-transform/cli optimize model.glb model.opt.glb --compress draco --texture-compress webp --texture-size 2048", exact loader-wiring imports, and a Node SDK pipeline — with flag defaults, exact error strings, and wrong→right Common Mistakes pairs covering the common cases. Matches the fully-executable anchor. | 5 / 5 |
Workflow Clarity | The sequence is explicit with validation checkpoints: "Run `inspect` before and after to see what the pass saved", `validate` "exits nonzero when errors are found, so it works as a CI gate", the ordering rule "Make `draco`, `meshopt` or `optimize` the last command in a chain", and per-error recovery via the Common Mistakes section (each missing loader piece with the exact exception it throws and its fix). Outputs are written to new files rather than destructively overwritten, and verification is present throughout, so the destructive/batch cap does not apply. | 5 / 5 |
Progressive Disclosure | No bundle files exist; the whole skill is one ~240-line SKILL.md with well-organized, clearly headed sections and a See Also delimiting sibling skills. Structure is good and navigation is easy, but it exceeds the simple-skill case and keeps advanced material (WebGPU/TSL, gltfjsx, Common Mistakes) fully inlined where reference files could carry it — good structure with minor organization gaps (anchor 4) rather than an appropriately split overview (anchor 5). | 4 / 5 |
Total | 18 / 20 Passed |