Content
71%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.
An unusually dense, expert-level reference: every rule carries exact formulas, constants and the failure it prevents, and the gotchas section provides symptom-first recovery guidance. The main weaknesses are the missing demo.html the body cites as its reference, the absence of an ordered build workflow, and small amounts of non-instructional provenance/self-score content.
Suggestions
Ship demo.html in the bundle (or remove the "demo.html is the reference" claim) so the cited reference implementation actually exists next to SKILL.md.
Add a short ordered build sequence (bake weave → integrate fold curve → build material → hems/stitches/fray → light and shadows → lifecycle) that indexes the 13 rules into a procedure with visual validation checkpoints per stage.
Trim the KIBORI provenance paragraph and the closing "Score against the rubric" self-assessment, or move them to a separate notes file, since neither instructs the reader how to build the material.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The rules are maximally dense with exact formulas and constants ("α(s) = a·(sinθ + 0.16 sin(2θ+0.8))", "sheen 0.5–1.0", "normalBias 0.012") and assume Claude's competence with no padding about what Three.js or cloth is. Not 5: the KIBORI provenance paragraph ("Extracted from KIBORI 木彫, a dark WebGL workshop...") and the closing self-assessment ("Score against the rubric ... Overall 6.5") are meta-content that does not instruct the reader and could be trimmed. | 4 / 5 |
Actionability | Mostly executable: exact GLSL/math expressions ("warp height blends ... by 0.5·smoothstep(0.05, 0.5, |t|)", "twill 2/1 = (A+B)%3 < 2"), a per-fabric constants table, and copy-ready parameter values. Not 5 because there is no complete copy-paste code block — the pieces must be assembled — and "demo.html is the reference" points to a file that is not present in the bundle, leaving the working example missing. | 4 / 5 |
Workflow Clarity | The 13 numbered rules each pair an instruction with the failure it prevents, and the "Gotchas, symptom first" section gives explicit symptom → cause → fix recovery loops (e.g. "Weave crawls or shimmers → uv was rebuilt from arc length; keep it as the rest metres"). Not 5: there is no explicit build sequence (material → bake → geometry → light) tying the rules into an ordered procedure, and visual validation checkpoints are implicit in the gotchas rather than stated steps. | 4 / 5 |
Progressive Disclosure | Sections are well organized (rules, constants, gotchas, lifecycle, cost), but the only bundle reference — "demo.html is the reference" — points to a file that does not exist (no references/, scripts/ or assets/ directories ship with the skill), so navigation dead-ends. This matches the middle anchor: structure is present, but the reference situation is broken and the full implementation the body leans on is missing. Not 4 because a claimed one-level reference that is absent is worse than minor organization gaps. | 3 / 5 |
Total | 15 / 20 Passed |