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 high-quality, dense reference: fully executable code throughout, correct version-pinned gotchas, and clear section structure. Its weaknesses are mild boilerplate repetition in the setup sections and the complete absence of bundle files — everything lives inline in one long SKILL.md when several sections would work better as one-level-deep references.
Suggestions
Split separable material into reference files — e.g., WebGPU/TSL specifics and light-probe baking — and link them one level deep ("See references/webgpu.md"), keeping SKILL.md as the overview.
Trim the Quick Start and WebGPU renderer/camera boilerplate to just the lines that differ from standard setup, since Claude already knows scene scaffolding.
Add a short diagnostic loop for shadow tuning (e.g., "if acne persists after bias, increase normalBias; if peter-panning appears, back off bias") to complete the tuning workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and high-signal, pinned to r186 with deprecations (r180–r183) correctly isolated in the Common Mistakes section acting as an old-patterns list. It falls short of anchor 5 because the Quick Start and WebGPU sections repeat renderer/camera boilerplate Claude already knows, and "Three-point lighting: key, fill, rim" restates a familiar concept. It is above anchor 3 because nearly every line carries version-specific or unit-specific facts rather than padding. | 4 / 5 |
Actionability | Every section provides fully executable, copy-paste-ready code covering the common cases: light setup, shadow tuning with concrete values ("dirLight.shadow.normalBias = 0.02; dirLight.shadow.bias = -0.0001"), IBL assignment, probe baking, and WebGPU registration lines. This matches the fully-executable anchor and is not anchor 4 since there are no pseudocode or missing-detail gaps. | 5 / 5 |
Workflow Clarity | Multi-step procedures are clearly sequenced — the shadow setup is numbered (renderer → light → objects) with three explicit switches, and shadow-camera tuning gives ordered, concrete parameters. It is not anchor 5 because tuning workflows (e.g., shadow acne) lack a diagnostic feedback loop ("if acne persists, increase normalBias"), though no destructive or batch operations exist to cap the score at 3. | 4 / 5 |
Progressive Disclosure | The body is well-organized with clear headers, but there is no progressive disclosure at all: no references/, scripts/, or assets/ files exist, and separable material (WebGPU/TSL specifics, light probe grids, per-light reference details) is inline in a single ~480-line file. This matches anchor 3 (good inline structure, but content that should be separate is inline) rather than anchor 4, which expects most bulk content placed in separate referenced files. | 3 / 5 |
Total | 16 / 20 Passed |