Content
65%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 highly actionable, code-dense reference whose Three.js-specific content (built-in uniforms, onBeforeCompile injection points, uniform update patterns, TSL) is genuinely valuable. Its weaknesses are structural: standard GLSL reference material that Claude already knows is inlined, and the single large file with no bundle split or explicit workflow makes it heavier on the context window than it needs to be.
Suggestions
Move the 'GLSL Built-in Functions' section (and optionally the basic Gradient/Noise snippets) into a references/ file or delete them — they restate GLSL spec knowledge Claude already has and cost ~80 lines of context.
Split the body into a lean SKILL.md (Quick Start, ShaderMaterial vs RawShaderMaterial, uniform update patterns, debugging) plus a references/patterns.md for the full effect cookbook (fresnel, rim, dissolve, instancing, TSL), one level deep and clearly signaled.
Add a short explicit workflow (create material → wire uniforms → update in animation loop → check compiler errors via renderer.debug / console output of shader sources) so the Debugging section becomes an explicit checkpoint rather than an isolated tip.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The Three.js-specific sections (built-in uniforms/attributes, onBeforeCompile injection points, uniform update patterns, TSL comparison) are dense and valuable, but the 'GLSL Built-in Functions' section (~55 lines of standard spec functions like abs, sin, mix, clamp) and the trivial 'Gradient' patterns restate what Claude already knows. Mostly efficient with a clearly cuttable block of padding — anchor 3, not 2 because the majority of the file is non-obvious, code-dense material. | 3 / 5 |
Actionability | Nearly every JavaScript example is complete and copy-paste ready (Quick Start, texture sampling, vertex displacement, fresnel, rim lighting, instancing, onBeforeCompile with its animation-loop update, TSL quick start), covering the common cases. The few GLSL fragments (noise, gradient, dissolve) are shader chunks — the natural reusable unit — with full boilerplate shown elsewhere, so this matches the top anchor rather than 4. | 5 / 5 |
Workflow Clarity | Well-organized as a reference (basics → patterns → extending materials → debugging), and the Debugging section covers compile-error checking and visual debugging, but there is no explicit end-to-end sequence or validation checkpoints for assembling a shader; the reader must synthesize their own process. Anchor 3 — sections are coherent and navigable (above 2) but lack an explicit step sequence (below 4). | 3 / 5 |
Progressive Disclosure | No bundle files exist; everything is inlined in a single ~690-line SKILL.md. Section headers are clear, but the inline GLSL function/API reference and the TSL section are exactly the 'content that should be separate is inline' pattern of anchor 3. Not 4: with a file this large, the split opportunities are more than minor organization gaps. | 3 / 5 |
Total | 14 / 20 Passed |