CtrlK
BlogDocsLog inGet started
Tessl Logo

claude-d3js-skill

This skill provides guidance for creating sophisticated, interactive data visualisations using d3.js.

51

Quality

56%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/claude-d3js-skill/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is an exemplary lean hub: concise, correctly scoped, and with nothing inlined that belongs in references. Its weakness is that the entry point exposes almost none of the bundle — one linked guide out of seven files — so discoverability of the patterns/scales/colour references and starter templates depends on a nested index that misdocuments the asset filenames, and the body itself carries no executable quick-start content.

Suggestions

Add a short '## Resources' section to SKILL.md indexing all bundle files, e.g., '**Patterns**: See [references/d3-patterns.md](references/d3-patterns.md)', '**Scales**: references/scale-reference.md', '**Colour schemes**: references/colour-schemes.md', '**Templates**: assets/chart-template.jsx, assets/interactive-template.jsx, assets/sample-data.json'.

Include a minimal quick-start snippet or 3-4 step summary in the body so a simple chart request can be served without loading the 811-line guide — the guide itself says 'For focused work, load the relevant sections', but the body gives no section index to load from.

Fix the asset filenames in references/detailed-guide.md's Resources section ('chart-template.js' and 'interactive-template.js' do not exist; the actual files are .jsx) so the documented paths resolve.

DimensionReasoningScore

Conciseness

The ~25-line body is lean with zero padding: a pointed pointer to the detailed guide ("Read the detailed guide before executing this skill... Treat its safety, prerequisites, and validation requirements as mandatory"), scoping bullets under "When to use d3.js", and a short limitations section. No concepts Claude already knows are explained, and every line carries scope or navigation information. It is not below 5 because nothing here could be trimmed without losing signal.

5 / 5

Actionability

The guidance that is present is concrete and unambiguous — read references/detailed-guide.md first, treat its validation requirements as mandatory, prefer Three.js for 3D, stop if inputs are missing — but all executable substance (code, commands, steps) is delegated to the reference file, leaving the body itself with directional rather than executable guidance. This matches anchor 3 (some concrete guidance but incomplete, key details missing) rather than 4, whose body-level content would itself be mostly executable.

3 / 5

Workflow Clarity

The only sequence the body expresses is 'read the guide, then follow it', with validation present but implicit — "Treat its safety, prerequisites, and validation requirements as mandatory" names validation without any checkpoint, and "Do not treat the output as a substitute for environment-specific validation, testing, or expert review" is a caveat rather than a step. No destructive or batch operations are involved, so the cap does not apply, but the actual multi-step workflow lives entirely in the reference, leaving the body at anchor 3 (sequence present, checkpoints missing/implicit) rather than 4.

3 / 5

Progressive Disclosure

Scored against the actual bundle: the body cleanly signals one reference (references/detailed-guide.md) and correctly inlines nothing that belongs in a separate file, but the other three reference files (d3-patterns.md, scale-reference.md, colour-schemes.md) and all three assets are never mentioned in SKILL.md — they are only discoverable two levels deep, inside the guide's 'Resources' section, which also misnames the assets ('chart-template.js'/'interactive-template.js' vs. the actual .jsx files). This is better than anchor 2 (nothing is wrongly inlined) but short of anchor 4's 'references mostly clear' because most of the bundle is unindexed from the entry point and one documented path is wrong.

3 / 5

Total

14

/

20

Passed

Description

48%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description names a specific, recognizable niche (d3.js interactive visualisations) but is thin: one generic action phrase, no use-when trigger guidance, and sparse natural keywords. It is functional but well below the quality of the reference good examples, which pair concrete capability lists with explicit trigger clauses.

Suggestions

Add an explicit 'Use when...' clause with concrete triggers, e.g., 'Use when the user asks for d3.js, custom/interactive charts, force-directed graphs, or visualisations requiring custom layouts or animated transitions.'

Replace 'provides guidance for creating' with 3-5 concrete capabilities, e.g., 'Build custom charts (bar, line, scatter, chord, heatmap), force-directed networks, geographic projections, and choreographed transitions with d3.js.'

Broaden natural trigger terms to include the words users actually say — chart, graph, plot, dashboard, 'd3', and the American spelling 'visualization(s)'.

DimensionReasoningScore

Specificity

The description names the domain ("interactive data visualisations using d3.js") but the only action is the generic "provides guidance for creating" — no concrete capabilities (e.g., chart types, transitions, interactions) are listed. It sits between anchor 1 (no domain) and anchor 3 (1-2 concrete actions): the domain is named clearly, but the action described is entirely generic.

2 / 5

Completeness

There is a recognizable 'what' (guidance for creating d3.js visualisations) but the 'when' is entirely absent — no "Use when..." clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. It is not 2 because the 'what' is domain-specific rather than vague, and not 4 because no use-when guidance exists at all, explicit or otherwise.

3 / 5

Trigger Term Quality

"d3.js" and "interactive data visualisations" are relevant keywords a user might say, but common natural terms are missing: chart, graph, plot, dashboard, the "d3" short form, and the American spelling "visualizations". This matches anchor 3 (some relevant keywords, missing common variations/synonyms) rather than anchor 4's good coverage.

3 / 5

Distinctiveness Conflict Risk

"using d3.js" carves out a clear niche with distinct triggers, giving mostly-distinct positioning with only minor overlap risk against general charting/visualization skills. It falls short of anchor 5 because, without any 'use when' scoping, a generic 'make me a chart' request could plausibly match this and a general dataviz skill.

4 / 5

Total

12

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
sickn33/agentic-awesome-skills
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.