tufte-claude-skill
Claude Code skill that turns 'make me a chart' into a Tufte-compliant chart. Distilled from Edward Tufte's three foundational books.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/aref-vc--tufte-claude-skill)HTML
<a href="/listings/aref-vc--tufte-claude-skill"><img src="/api/listings/aref-vc--tufte-claude-skill/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Clone into your Claude Code skills directory:
git clone https://github.com/aref-vc/tufte-claude-skill.git ~/.claude/skills/tufte
That's it. Claude Code auto-loads the skill on next launch. To verify, run `/tufte` or ask Claude to "make a chart of anything."
To update later:
cd ~/.claude/skills/tufte && git pull
To uninstall:
rm -rf ~/.claude/skills/tufte
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 84 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ---
- name: tufte
- description: Apply Edward Tufte's principles to any data visualization, chart, dashboard, or infographic. Use when the user asks to produce, design, critique, or improve a chart, graph, dashboard, KPI tile, table-with-data, sparkline, small multiple, time series, distribution plot, choropleth, or any other visual that communicates quantitative or categorical information. Also triggers on words like "visualize", "viz", "data viz", "chart", "graph", "dashboard", "infographic", "Tufte". Outputs Tufte-compliant designs in either self-contained HTML/SVG or React (Recharts/D3). Defaults to Tufte rules; user can opt out per chart.
- ---
- # Tufte — visual display, by the book
- This skill turns "make me a chart" into a Tufte-compliant chart. Distilled from *The Visual Display of Quantitative Information* (1983/2001), *Envisioning Information* (1990), and *Visual Explanations* (1997).
- ## What this skill produces
- Two output stacks, selected by the user's project context:
- 1. **Self-contained HTML/SVG** — single file, inline SVG, no external deps. For one-offs, embeds, screenshots, slide decks.
- 2. **React (Recharts + D3 fallback)** — for projects that already use React. Recharts where the chart type fits; raw D3-in-React where it doesn't (slopegraph, sparkline-in-table, small multiples).
- ## How to use this skill
- When invoked, work through these in order:
- 1. **Read `principles.md`** — 10 rules, one paragraph each. The whole frame.
- 2. **Use `chart-selection.md`** to pick the chart type from the user's data and goal. Don't reach for a chart you know; reach for the one this table prescribes.
- 3. **Apply `kill-list.md`** before rendering — strip the things that don't belong in any Tufte-compliant chart.
- 4. **Check `before-after.html`** when the user wants to see the difference. Six side-by-side examples covering the cases AI tools default to badly.
- 5. **Read `report-voice.md`** when the output is a report, recap, or slide with prose around the chart. The writing can ruin a clean chart. Plain business English, no em-dashes, no AI slop.
- 6. **Run `checklist.md`** before declaring the chart done. Twenty items, takes 30 seconds.
- For a quick lookup, `cheatsheet.html` (and `cheatsheet.pdf`) is the one-page reference.
- ## Default behavior
- Tufte rules apply by default. If the user explicitly requests something on the kill list ("I need a pie chart for this board deck because the CFO wants one"), comply, but note the Tufte alternative in a one-line comment in the code or the response.
- ## Prose around the chart
- When the output is a report, recap, or slide, the text matters as much as the
- chart. Write plain business English: no em-dashes, no drama or theatrics, no hype
- verbs, no AI-slop jargon. Name every label and caption for the specific case, not
- a placeholder. First the number, then what it means. See `report-voice.md` for
- the full kill/keep list. A clean chart wrapped in slop reads as slop.
- ## The kill list, summarized
- These are not in any Tufte-compliant chart unless the user explicitly overrides:
- - 3D effects on any 2D quantity
- - Pie charts (use a sorted bar or a small table)
- - Dual-axis charts (use two small multiples instead)
- - Rainbow color scales for ordered data (use sequential single-hue)
- - Heavy gridlines, frame boxes, tick marks at every minor unit
- - Drop shadows, gradient fills, bevels, glow, "ducks"
- - Legends placed away from data (label data directly)
- - Moiré patterns, cross-hatching, dense stippling
- - Redundant data-ink (bar plus number plus axis plus gridline all showing the same quantity)
- - KPI cards with giant numbers and no context
- ## The keep list
- These belong in most Tufte charts:
- - Direct labels on data (no legends)
- - Sparklines next to numbers
- - Small multiples for any cross-cut
- - Range frames (axes only span where data exists)
- - Subtle gridlines (white-on-light, or omit)
- - A single accent color (`--accent` red), **actually applied to the focal data point** — not declared and left unused. Minimal ink is not the same as no signal. If nothing carries the accent, the chart is flat; pick the point the reader should look at and color it.
- - Data marks where they aid reading: dots on line endpoints, dot plots in place of bare bars
- - Sorted categories (rarely alphabetical, almost never as-input)
- - Tables when n ≤ ~20 and exact values matter
- ## File index
- | File | Purpose |
- |---|---|
- | `principles.md` | Tufte's 10 rules with practical interpretation |
- | `chart-selection.md` | Data + goal → chart type decision table |
- | `kill-list.md` | What to remove from any chart |
- | `before-after.html` | Six side-by-side comparisons (open in browser) |
- | `report-voice.md` | Prose rules for reports/recaps/slides (no slop, no em-dashes) |
- | `checklist.md` | 20-item pre-publish check |
- | `cheatsheet.html` | One-page printable reference |
- | `cheatsheet.pdf` | Same, as PDF |
- | `presets/html-svg.md` | Style tokens + a working SVG bar chart, line chart, sparkline, small multiple |
- | `presets/react.md` | Recharts theme + D3 patterns for slopegraph, sparkline-in-table, small multiples |
README.md · README · 247 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # tufte-claude-skill
- A Claude Code skill that turns "make me a chart" into a Tufte-compliant chart. Distilled from the three foundational books by Edward R. Tufte.
- <table>
- <tr>
- <td align="center" width="33%"><img src="assets/vdqi-cover.svg" alt="The Visual Display of Quantitative Information" width="240"/></td>
- <td align="center" width="33%"><img src="assets/ei-cover.svg" alt="Envisioning Information" width="240"/></td>
- <td align="center" width="33%"><img src="assets/ve-cover.svg" alt="Visual Explanations" width="240"/></td>
- </tr>
- <tr>
- <td align="center"><b>The Visual Display of Quantitative Information</b><br/><i>1983 · 2nd ed. 2001</i><br/><sub>pictures of <b>numbers</b></sub></td>
- <td align="center"><b>Envisioning Information</b><br/><i>1990</i><br/><sub>pictures of <b>nouns</b></sub></td>
- <td align="center"><b>Visual Explanations</b><br/><i>1997</i><br/><sub>pictures of <b>verbs</b></sub></td>
- </tr>
- </table>
- ---
- ## Install
- Clone into your Claude Code skills directory:
- ```bash
- git clone https://github.com/aref-vc/tufte-claude-skill.git ~/.claude/skills/tufte
- ```
- That's it. Claude Code auto-loads the skill on next launch. To verify, run `/tufte` or ask Claude to "make a chart of anything."
- To update later:
- ```bash
- cd ~/.claude/skills/tufte && git pull
- ```
- To uninstall:
- ```bash
- rm -rf ~/.claude/skills/tufte
- ```
- ---
- ## The three books, distilled
- Tufte gives the three-book taxonomy himself on page 9 of *Visual Explanations*:
- - **VDQI** — how to depict data and enforce statistical honesty. The book that gave us *data-ink ratio*, *chartjunk*, *lie factor*, *small multiples*.
- - **EI** — how to lay out information in space. Layering, micro/macro readings, color rules, escaping flatland.
- - **VE** — how to show motion, causality, narrative. The smallest effective difference, parallelism, visual confections.
- Together they yield the ten principles this skill applies.
- ### The ten principles
- 1. **Show the data.** Above all else. Every other decision asks "does this help the reader see the data?"
- 2. **Maximize the data-ink ratio.** Ink that would change if the data changed is data-ink. Everything else is overhead.
- 3. **Erase non-data-ink.** Drop the frame box, drop the gridlines, drop the ticks at minor units.
- 4. **Erase redundant data-ink.** Pick one encoding per quantity. A bar plus a number plus a gridline plus an axis tick all saying "37" is one thing said four times.
- 5. **Graphical integrity.** Lie factor between 0.95 and 1.05. Bar charts start at zero. Never use area for a 1D quantity.
- 6. **Small multiples.** When you have a cross-cut (region, segment, cohort), make N small charts on a shared scale instead of one chart with N lines.
- 7. **Layering and separation.** Data on top, labels next, scaffolding faintest. Watch for the *1+1=3 effect* — when two heavy elements interact to create unintended visual noise.
- 8. **Micro/macro readings.** Good charts work at two scales: one shape from across the room, every data point legible up close.
- 9. **The smallest effective difference.** "Make all visual distinctions as subtle as possible, but still clear and effective." Gray for context, one accent for focus.
- 10. **Word-data integration.** Sparklines belong in sentences. Numbers belong next to their visual. Tables are charts too.
- Tufte's own five-line summary from VDQI p.105:
- > Above all else show the data.
- > Maximize the data-ink ratio.
- > Erase non-data-ink.
- > Erase redundant data-ink.
- > Revise and edit.
- ---
- ## How the skill works
- When you ask Claude to make, design, critique, or improve any chart, the skill activates automatically. It then:
- 1. **Reads `principles.md`** to recall the ten rules.
- 2. **Picks the chart type** from `chart-selection.md` based on your data shape and goal — not from what's familiar or what the library makes easy.
- 3. **Applies `kill-list.md`** — removes the things that don't belong (3D, pie, dual-axis, rainbow scales, frame boxes, redundant legends).
- 4. **Produces the chart** in your preferred stack: self-contained HTML/SVG, or React (Recharts + D3).
- 5. **Runs `checklist.md`** as a final pass before declaring it done.
- Default strictness: Tufte by default, override per chart on request ("I need a pie because the CFO wants one" → comply, but note the alternative).
- ---
- ## The one-page cheatsheet
- A printable reference covering principles, lie-factor formula, chart-selection table, kill list, color rules, and the 12-item checklist. Open [`cheatsheet.html`](./cheatsheet.html) in a browser or print [`cheatsheet.pdf`](./cheatsheet.pdf).
- 
- ---
- ## Before and after
- Nine pairs comparing typical AI/BI default output (left) to Tufte-applied output (right). The full interactive gallery is at [`before-after.html`](./before-after.html) — open in any browser. Six pairs inlined here:
- ### 1. Category comparison — sales by product
- 
- 3D bars with a six-color rainbow legend become a sorted dot plot with direct labels. The reader ranks in two seconds instead of decoding a key.
- ### 2. Time series — monthly active users
- 
- A line chart trapped in a frame box (with gridlines, legend, axis title, chart title) becomes a sparkline plus the current value plus two endpoint labels. Same data, ~80% less ink.
- ### 3. Dashboard — four KPIs
- 
- Four KPI tiles with giant numbers and decorative icons become a compact table with value, sparkline (10-month trend), and delta-to-target. One accent color flags the metric that's off-target.
- ### 4. Period comparison — Q2 vs Q3 by team
- 
- Clustered bars (two colors, ten bars to mentally pair up) become a slopegraph. Each line's slope is the change. Steepest gainer and only decliner read instantly without decoding a legend.
- ### 5. Conversion funnel — signup flow
- 
- A 3D tapered funnel chart (where the visual taper exaggerates the drop-off) becomes horizontal bars sized by share of stage 1, with retention percentage printed per step. The worst step is annotated.
- ### 6. Cohort retention
- 
- A rainbow heatmap (where viewers guess if yellow is more than green) becomes a sequential single-hue table with numbers printed in every cell and a sparkline showing each cohort's decay shape.
- The other three pairs in the gallery: part-to-whole (pie → sorted table), distribution (rainbow histogram → strip plot with quantile markers), geographic (rainbow choropleth → sequential single-hue with annotations).
- ---
- ## When to use the skill
- The skill auto-activates on any of these:
- - "Make a chart of...", "visualize...", "graph...", "plot..."
- - "Build a dashboard for...", "design a KPI tile..."
- - "Improve this chart", "critique this visual"
- - "What chart should I use for...?"
- - Direct invocation: `/tufte` or mentioning Tufte by name
- - Any project where chart code is being added or edited
- It does *not* activate for:
- - Logo design, illustration, or decorative graphics
- - Flowcharts, architecture diagrams, hand-drawn sketches
- - Pure typography or layout that has no quantitative data
- ---
- ## How to use the skill
- ### Fast path
- Just ask. The skill loads automatically and produces a Tufte-compliant chart:
- > Make a chart of monthly revenue for the last 12 months
- You'll get a sparkline with the current value, two endpoint labels, no frame box, no legend.
- ### Stack choice
- Tell Claude which output you want:
- | Say | You'll get |
- |---|---|
- | "as inline SVG" or no preference | Self-contained HTML/SVG, single file |
- | "in React" or "with Recharts" | Recharts component with Tufte theme |
- | "with D3" | D3-in-React (for dot plots, slopegraphs, custom small multiples) |
- ### Override the defaults
- If you specifically need something on the kill list:
- > Make a pie chart of revenue mix — the CFO wants a pie
- Claude will produce the pie, but include a one-line comment noting the Tufte alternative (a sorted table). You stay in control.
- ### Iterate on an existing chart
- Paste your chart code or screenshot and say:
- > Apply Tufte to this
- Claude will identify violations (frame box, gridlines, gradient fills, redundant legend, wrong sort), and produce a rewritten version.
- ---
- ## File index
- | File | Purpose |
- |---|---|
- | [`SKILL.md`](./SKILL.md) | Trigger description + skill index (loaded by Claude) |
- | [`principles.md`](./principles.md) | The ten rules, with Tufte's exact quotes |
- | [`chart-selection.md`](./chart-selection.md) | Data + goal → chart type decision table |
- | [`kill-list.md`](./kill-list.md) | What to remove from any chart |
- | [`before-after.html`](./before-after.html) | Nine side-by-side comparisons (open in browser) |
- | [`checklist.md`](./checklist.md) | 12-item pre-publish check |
- | [`cheatsheet.html`](./cheatsheet.html) / [`cheatsheet.pdf`](./cheatsheet.pdf) | One-page printable reference |
- | [`presets/html-svg.md`](./presets/html-svg.md) | Style tokens + working SVG templates (sparkline, dot plot, line, small multiples, sparkline-in-table) |
- | [`presets/react.md`](./presets/react.md) | Recharts theme + D3-in-React patterns (slopegraph, dot plot, what-to-never-import list) |
- ---
- ## Requirements
- - [Claude Code](https://docs.claude.com/en/docs/claude-code) installed
- - Skill auto-loads from `~/.claude/skills/`
- - No other dependencies for the skill itself
- - The cheatsheet PDF is included, but to regenerate it from the HTML you'll need [`weasyprint`](https://weasyprint.org/) (`pip install weasyprint`)
- ---
- ## Contributing
- Pull requests welcome. Useful additions:
- - More before/after pairs (sankey, network, gantt, calendar heatmap, control chart)
- - Output presets for other stacks: Python (matplotlib, plotly), Observable Plot, Vega-Lite, ggplot2
- - Examples that show Tufte applied to real-world charts you've improved
- Open an issue first for anything that adds a new chart type to the decision table — let's discuss the rule before adding it.
- ---
- ## License
- [MIT](./LICENSE). Use it, modify it, ship it.
- The skill content is original; quotations from Tufte's books are used under fair-use for educational reference and are attributed inline.
- ---
- > The principles of information design are universal — like mathematics — and are not tied to unique features of a particular language or culture.
- >
- > — Edward R. Tufte, *Envisioning Information*, p. 10
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.