CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

claude-d3js-skill

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

Quality

67%

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

67%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.

A well-structured, lean overview that delegates execution detail appropriately and includes thoughtful scope boundaries and a stop-and-ask checkpoint. Its main weaknesses are that the body itself offers no quick-start or executable guidance and does not surface the supporting bundle files directly, forcing all focused work through the single detailed guide.

Suggestions

Add a one-line index of the supporting files directly in the body (e.g., 'Patterns: references/d3-patterns.md; Scales: references/scale-reference.md; Colours: references/colour-schemes.md; Templates: assets/chart-template.jsx') so focused work can skip the full guide.

Include a minimal quick-start snippet or a single representative d3 pattern inline so the skill is partially actionable before the guide is loaded.

Trim the redundant first Limitations bullet, which restates the 'When to use d3.js' section.

DimensionReasoningScore

Conciseness

The body is lean, assumes Claude's competence, and spends its tokens on genuinely useful scoping ('Interactive explorations with complex pan, zoom, or brush behaviours', 'Geographic visualisations with custom projections'). However, the Limitations bullet 'Use this skill only when the task clearly matches the scope described above' duplicates the preceding 'When to use d3.js' section, a minor trimmable instance — anchor 4, not 5's 'every token earns its place'.

4 / 5

Actionability

There is a concrete, verifiable pointer ('Read [the detailed guide](references/detailed-guide.md) before executing this skill') and specific selection criteria, but every executable step is deferred to the reference — the body itself contains no commands, code, or how-to steps. This matches 'some concrete guidance but incomplete', short of anchor 4's 'concrete code or commands with minor gaps'.

3 / 5

Workflow Clarity

A clear sequence is present: check the 'When to use' scope, read the guide (with focused vs. end-to-end loading guidance), and stop points exist ('Stop and ask for clarification if required inputs... are missing'). No destructive or batch operations are involved, so no cap applies; it falls short of anchor 5 only because execution checkpoints live entirely in the referenced guide rather than the body.

4 / 5

Progressive Disclosure

The body is a clear overview with a well-signaled, one-level-deep reference, and the referenced detailed-guide.md genuinely exists and indexes the remaining bundle files (d3-patterns.md, scale-reference.md, colour-schemes.md, chart-template.jsx, interactive-template.jsx, sample-data.json). It misses anchor 5 because the SKILL.md body itself provides no direct map to those files, so focused work (e.g., choosing a colour scheme) must load the full guide first.

4 / 5

Total

15

/

20

Passed

Description

53%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 clear domain (d3.js visualisations) and stays concise, but it is one generic action short of specific, has no 'Use when...' trigger clause, and misses common natural keywords like chart, graph, and dashboard. It is functional but below the standard of the good examples, which pair concrete capabilities with explicit trigger phrases.

Suggestions

Add an explicit trigger clause, e.g., 'Use when the user needs custom, interactive, or novel visualisations with d3.js, or mentions d3, force-directed graphs, custom chart layouts, or visualisations standard chart libraries can't produce.'

Replace the buzzword 'sophisticated' with concrete capabilities, e.g., 'Build custom charts, force-directed network graphs, tree/hierarchy diagrams, geographic projections, and animated transitions with d3.js.'

Include natural synonyms and file/tech markers users say — 'chart', 'graph', 'plot', 'dashboard', 'd3', 'SVG' — to improve trigger-term coverage.

DimensionReasoningScore

Specificity

"creating sophisticated, interactive data visualisations using d3.js" names the domain and one action with the 'interactive' attribute, but 'sophisticated' is fluff and no concrete capabilities (e.g., force-directed graphs, custom projections) are enumerated. It matches the 'names domain and 1-2 concrete actions, but not comprehensive' anchor — above anchor 2 because an action beyond the bare domain is stated, below anchor 4 because only one generic action is listed.

3 / 5

Completeness

A 'what' is present ("provides guidance for creating... data visualisations using d3.js") but the description contains no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3. Not 4, because the 'when' is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

The only natural terms are "d3.js" and "data visualisations"; common variations users actually say — chart, graph, plot, dashboard — are all missing. This matches 'some relevant keywords but missing common variations or synonyms', not anchor 4 where only a few natural terms are absent.

3 / 5

Distinctiveness Conflict Risk

Naming d3.js explicitly carves a mostly distinct niche unlikely to trigger for unrelated skills, but the broad phrase "sophisticated, interactive data visualisations" overlaps generic charting/dataviz skills without disambiguating (e.g., 'custom or novel visualisations not available in standard chart libraries'). Minor overlap risk with closely related skills matches anchor 4, short of anchor 5's 'clear niche with distinct triggers'.

4 / 5

Total

13

/

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

Path

skills/claude-d3js-skill/SKILL.md

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.