Content
46%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.
The body delivers abundant concrete, executable R3F code, but as a monolithic 780-line inline reference it heavily duplicates knowledge Claude already has and ignores progressive disclosure entirely — no reference files split out the JSX catalog, event properties, or Leva debugging guide. Restructuring into a lean overview plus one-level-deep reference files would fix both the conciseness and structure problems at once.
Suggestions
Split the body into one-level-deep reference files (e.g., references/jsx-elements.md, references/events.md, references/leva-debugging.md) and reduce SKILL.md to a concise overview with clearly signaled links, keeping only the Quick Start inline.
Trim sections that restate what Claude already knows (Canvas Defaults, basic JSX camelCase usage, event bubbling) and move the 130-line Leva guide out of the fundamentals skill or into its own reference, since it documents a third-party tool beyond R3F core.
Fix non-executable example fragments — the Canvas props showcase has a duplicate `camera` prop alongside `orthographic`, and `ConditionalAnimation`/`TriggerRender` use an undeclared `meshRef` — or explicitly label them as prop documentation rather than runnable code.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~780-line body extensively restates well-known R3F knowledge Claude already has ("All Three.js objects are available as JSX elements (camelCase)", "Events bubble up through the scene graph", Canvas defaults), and the ~130-line Leva debugging guide covers a third-party tool beyond R3F fundamentals. This is noticeably verbose at the section level, matching anchor 2 rather than 3, where padding is only a stray sentence or two. | 2 / 5 |
Actionability | Mostly executable, copy-paste-ready TSX covering Quick Start, hooks, events, refs, and performance patterns. Minor gaps keep it below anchor 5: the Canvas props block is a non-executable showcase (duplicate `camera` prop with `orthographic`), and fragments like ConditionalAnimation and TriggerRender reference a `meshRef` that is never declared. | 4 / 5 |
Workflow Clarity | Organized as a topical API reference rather than a sequenced workflow; the Quick Start gives an entry sequence but there is no guidance for navigating scenarios (e.g., choosing frameloop modes vs. invalidate) or checkpoints. Anchor 3 — structure present but no explicit workflow path; no validation cap applies since nothing destructive or batch-oriented is involved. | 3 / 5 |
Progressive Disclosure | No bundle files exist (no references/, scripts/, or assets/), and roughly 780 lines of API reference — event property tables, JSX element catalog, and the entire Leva guide — are inlined in SKILL.md where a reference file clearly belongs. Internal section headers are good, but per anchor 2 ("content that clearly belongs in separate files is inlined"), file-level structure is effectively monolithic; the See Also list points to sibling skills, not navigable bundle files. | 2 / 5 |
Total | 11 / 20 Passed |