Content
78%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 dense, highly actionable shader reference with excellent copy-paste code across GLSL and TSL. Its main weakness is progressive disclosure: with no bundle files, the entire pattern library and function cheatset live inline in one large SKILL.md rather than being split into referenced subfiles.
Suggestions
Move the "GLSL Built-in Functions" cheatsheet into a references/ file (e.g. references/gsl-reference.md) and link to it, since Claude already knows these functions and it adds bulk without earning its tokens.
Extract the "Common Shader Patterns" library into references/patterns.md, keeping only one or two canonical examples inline in SKILL.md with a clearly signaled link.
Add a short "How to approach a shader task" sequencing note (pick material type -> define uniforms -> write vertex/fragment -> verify in renderer.debug) to give the reference an explicit workflow spine.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | A lean, code-forward reference that assumes Claude's competence and avoids explaining what shaders/GLSL are, though the "GLSL Built-in Functions" cheatsheet (abs, sin, cos, mix, etc.) largely restates functions Claude already knows and could be trimmed. | 4 / 5 |
Actionability | Dozens of complete, copy-paste-ready ShaderMaterial/RawShaderMaterial snippets covering uniforms, varyings, displacement, Fresnel, noise, dissolve, onBeforeCompile, instancing, and TSL, all directly executable. | 5 / 5 |
Workflow Clarity | A Quick Start establishes the entry point and the document flows logically from basics to advanced patterns with no destructive/batch operations requiring validation; it is a reference catalog rather than a sequenced process, so it stops just short of explicit checkpoint-driven workflows. | 4 / 5 |
Progressive Disclosure | Section headers and a Quick Start give it real structure, but ~680 lines of content (the full effect-pattern library, GLSL function cheatsheet, TSL guide) are all inlined in SKILL.md with no bundle files or one-level-deep references to split the bulk into, so content that should be progressively disclosed is monolithic. | 3 / 5 |
Total | 16 / 20 Passed |