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.
A highly actionable body with excellent executable examples and a clear core workflow, but it underuses its own bundle files by inlining pattern and scale material that already lives in references/, and it misstates asset filenames.
Suggestions
Move the detailed pattern catalog (bar/line/scatter/chord/heatmap/pie/force-directed) and the scales reference out of SKILL.md and point to references/d3-patterns.md and scale-reference.md instead, keeping only a concise quick-start inline.
Fix the asset filenames in the Resources section to match the actual bundle files (chart-template.jsx and interactive-template.jsx, not .js).
Tighten the Overview to remove general d3 background Claude already knows, and consolidate the 'Consider alternatives' list or remove the single-item placeholder.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~820-line body inlines a full pattern catalog (bar, line, scatter, chord, heatmap, pie, force-directed) and a complete scales reference that duplicate the existing references/d3-patterns.md and scale-reference.md, alongside a mildly padded Overview. | 3 / 5 |
Actionability | Provides copy-paste-ready, complete functions (e.g. drawBarChart, drawHeatmap, drawChordDiagram) covering the common visualisation cases with executable d3 code. | 5 / 5 |
Workflow Clarity | A numbered Core workflow (set up d3, choose integration pattern, structure code, responsive sizing) gives a clear sequence, plus a Common issues section for recovery, though explicit validation checkpoints are not called out. | 4 / 5 |
Progressive Disclosure | References and assets are listed in a Resources section, but the pattern examples and scales reference that have dedicated bundle files are inlined in the body rather than offloaded, and the asset filenames are misstated (chart-template.js / interactive-template.js vs the actual .jsx files). | 3 / 5 |
Total | 15 / 20 Passed |