chart-clarity

chart-clarity is a skill for Claude Code from Mathews-Tom/armory. It costs 120 tokens per session (2,254 once invoked), scanned A, original, MIT.

A set of guidelines for creating and reviewing charts and other data visualizations. It focuses on making comparisons easy to read, using clear labels, accessible colors, responsive layouts, and honest scales.

In plain words
What is it for?
Use it to create or improve charts, plots, dashboards, tables, and visual reports. It applies to tools including Recharts, Chart.js, matplotlib, Plotly, SVG, and D3.
Why use it?
It helps remove decoration, clutter, confusing numbers, and misleading comparisons from graphs. It also considers readability on screens, in dark mode, and with accessibility needs.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: positional $N argument.

Part of the armory plugin — 85 skills shipped together

Good fit Use it to create or improve charts, plots, dashboards, tables, and visual reports. It applies to tools including Recharts, Chart.js, matplotlib, Plotly, SVG, and D3.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/mathews-tom/armory/chart-clarity
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add Mathews-Tom/armory --skill chart-clarity
Clone the repo
git clone --depth 1 https://github.com/Mathews-Tom/armory

Made for: Claude Code.

Or install armory, the plugin that ships this one along with the rest of its 85 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for chart-clarity

README.md
[![agentmods](https://agentmods.dev/badge/skills/mathews-tom/armory/chart-clarity.svg)](https://agentmods.dev/skills/mathews-tom/armory/chart-clarity)
Your own site
<a href="https://agentmods.dev/skills/mathews-tom/armory/chart-clarity"><img src="https://agentmods.dev/badge/skills/mathews-tom/armory/chart-clarity.svg" alt="Measured on agentmods" height="20"></a>
Per session 120 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,254 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00120 $0.02254
Opus 5 $0.00060 $0.01127
Sonnet 5 $0.00024 $0.00451
Haiku 4.5 $0.00012 $0.00225

Measured 8d ago against content hash 6673d21d33cf, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

chart-clarity scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

The scan reads SKILL.md. This mod also ships 4 executable files (references/examples/chartjs-tufte-plugin.js, references/examples/echarts-tufte-theme.ts, references/examples/matplotlib-tufte-annotated.py, …), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/chart-clarity/SKILL.md · 137 lines

How it starts

The opening of the file, as written. The whole thing — 137 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Chart Clarity

Create and critique charts that make quantitative comparisons obvious without decorative chartjunk. This skill adapts Caylent's MIT-licensed tufte-data-viz skill into armory under the broader chart-clarity name. It applies Edward Tufte's core data visualization principles and adds screen-first requirements for accessibility, responsiveness, dark mode, progressive disclosure, and human-readable numbers.

Use this skill whenever the user asks for a chart, graph, plot, dashboard visualization, sparkline, slopegraph, data table, or visualization review. It covers Recharts, ECharts, Chart.js, matplotlib, Plotly, seaborn, D3.js, SVG, and HTML.

When to Use

User need Use chart-clarity Use instead
Generate chart code in Recharts, Plotly, matplotlib, Chart.js, ECharts, D3, SVG, or HTML Yes
Review an existing chart for misleading design, clutter, accessibility, or readability Yes
Restyle dashboard charts while keeping the dashboard structure unchanged Yes ux-expert for broader dashboard UX
Build a static infographic or rich HTML artifact around charts No static-web-artifacts-builder
Design a slide deck or presentation using charts No html-presentation, marp-slides, or pptx
Design logos, posters, icons, or non-data visuals No concept-to-image or canvas-design

Trigger Families

  • Chart creation: "create a chart", "plot this data", "make a graph", "build a sparkline", "generate a slopegraph".
  • Chart review: "review this visualization", "what is wrong with this graph", "make this chart clearer", "remove chartjunk".
  • Tufte-specific: "Tufte chart", "high data-ink ratio", "range-frame axes", "small multiples", "direct labels".
  • Library-specific: "Recharts", "ECharts", "Chart.js", "matplotlib", "seaborn", "Plotly", "D3", "SVG chart".

Workflow

Follow this order for every chart task.

  1. Identify the message. Determine the finding the chart needs to make visible. A useful title states the finding: "Revenue Beat Target by 24% in Q2", not "Revenue by Month".
  2. Identify comparison context. Add a baseline, prior period, target, average, peer group, or distribution. A number without comparison context is weak evidence.
  3. Choose the chart type. Use the data shape to select line, horizontal bar, scatter, small multiple, sparkline, slopegraph, heatmap, or table. Refuse pie charts by default; use sorted horizontal bars unless the user explicitly asks for a pie chart.
  4. Apply the universal rules. Remove decorative ink, direct-label series, use gray-first color, annotate notable features, format numbers for humans, and ensure the chart earns its space.
  5. Read one library reference. For implementation code, read exactly one matching library file from references/rules/ unless the task compares multiple libraries.
  6. Validate before presenting. Run the checklist at the end of this file against the final chart or review output.

Read the full file on GitHub · 137 lines

Files

What ships with it

32 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 137 lines · 120 tokens per session scan A 6673d21d33cf

Subscribe to this mod's changes

chart-clarity is a skill published in the GitHub repository Mathews-Tom/armory (316 stars, last pushed 2d ago), licensed MIT. It adds 120 tokens to every session and 2,254 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

art-director

Orchestrate iterative visual style searches with branch prompts, decision graphs, feedback loops, and final direction selection.

serejaris/personal-corp-os · 26 tokens

html-draft

Use when user wants a standalone HTML diagram in flat engineering blueprint style — architecture diagrams, system flows, technical spec sheets, component maps. Generates one HTML file using Tailwind v4 (browser CDN) for layout and D3 v7 (CDN) for SVG diagrams. User-invoked only — do NOT auto-trigger. Triggers on…

serejaris/personal-corp-os · 130 tokens

parallel-design-variants

A workflow for producing several genuinely different visual design directions at the same time. It uses distinct visual references, gathers the results into a comparison gallery, and can support choosing winners before another design round.

serejaris/personal-corp-os · 91 tokens

idea-superpowers-suite

Use when running the full idea workflow: capture a rough idea, expand it into design/UI/implementation docs, research similar products, and generate build-ready Markdown artifacts.

AkoliteZA/hermes-agent-idea-workflow · 38 tokens

idea-to-ui-design-brief

Use when turning a product/design doc into a focused UI design brief, optional AI image-generation concept prompts, and implementation-ready UI direction without replacing the main idea workflow.

AkoliteZA/hermes-agent-idea-workflow · 40 tokens

idea-to-design-doc

Use when turning a rough idea into a focused product/design Markdown doc through guided questions, without moving into implementation too early.

AkoliteZA/hermes-agent-idea-workflow · 29 tokens