Skip to content
Back to search

tufte-claude-skill

SkillWorks with Claude CodeGitHub

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/aref-vc--tufte-claude-skill/badge.svg)](/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

i

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)

  1. ---
  2. name: tufte
  3. 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.
  4. ---
  5. # Tufte — visual display, by the book
  6. 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).
  7. ## What this skill produces
  8. Two output stacks, selected by the user's project context:
  9. 1. **Self-contained HTML/SVG** — single file, inline SVG, no external deps. For one-offs, embeds, screenshots, slide decks.
  10. 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).
  11. ## How to use this skill
  12. When invoked, work through these in order:
  13. 1. **Read `principles.md`** — 10 rules, one paragraph each. The whole frame.
  14. 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.
  15. 3. **Apply `kill-list.md`** before rendering — strip the things that don't belong in any Tufte-compliant chart.
  16. 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.
  17. 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.
  18. 6. **Run `checklist.md`** before declaring the chart done. Twenty items, takes 30 seconds.
  19. For a quick lookup, `cheatsheet.html` (and `cheatsheet.pdf`) is the one-page reference.
  20. ## Default behavior
  21. 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.
  22. ## Prose around the chart
  23. When the output is a report, recap, or slide, the text matters as much as the
  24. chart. Write plain business English: no em-dashes, no drama or theatrics, no hype
  25. verbs, no AI-slop jargon. Name every label and caption for the specific case, not
  26. a placeholder. First the number, then what it means. See `report-voice.md` for
  27. the full kill/keep list. A clean chart wrapped in slop reads as slop.
  28. ## The kill list, summarized
  29. These are not in any Tufte-compliant chart unless the user explicitly overrides:
  30. - 3D effects on any 2D quantity
  31. - Pie charts (use a sorted bar or a small table)
  32. - Dual-axis charts (use two small multiples instead)
  33. - Rainbow color scales for ordered data (use sequential single-hue)
  34. - Heavy gridlines, frame boxes, tick marks at every minor unit
  35. - Drop shadows, gradient fills, bevels, glow, "ducks"
  36. - Legends placed away from data (label data directly)
  37. - Moiré patterns, cross-hatching, dense stippling
  38. - Redundant data-ink (bar plus number plus axis plus gridline all showing the same quantity)
  39. - KPI cards with giant numbers and no context
  40. ## The keep list
  41. These belong in most Tufte charts:
  42. - Direct labels on data (no legends)
  43. - Sparklines next to numbers
  44. - Small multiples for any cross-cut
  45. - Range frames (axes only span where data exists)
  46. - Subtle gridlines (white-on-light, or omit)
  47. - 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.
  48. - Data marks where they aid reading: dots on line endpoints, dot plots in place of bare bars
  49. - Sorted categories (rarely alphabetical, almost never as-input)
  50. - Tables when n ≤ ~20 and exact values matter
  51. ## File index
  52. | File | Purpose |
  53. |---|---|
  54. | `principles.md` | Tufte's 10 rules with practical interpretation |
  55. | `chart-selection.md` | Data + goal → chart type decision table |
  56. | `kill-list.md` | What to remove from any chart |
  57. | `before-after.html` | Six side-by-side comparisons (open in browser) |
  58. | `report-voice.md` | Prose rules for reports/recaps/slides (no slop, no em-dashes) |
  59. | `checklist.md` | 20-item pre-publish check |
  60. | `cheatsheet.html` | One-page printable reference |
  61. | `cheatsheet.pdf` | Same, as PDF |
  62. | `presets/html-svg.md` | Style tokens + a working SVG bar chart, line chart, sparkline, small multiple |
  63. | `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)

  1. # tufte-claude-skill
  2. 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.
  3. <table>
  4. <tr>
  5. <td align="center" width="33%"><img src="assets/vdqi-cover.svg" alt="The Visual Display of Quantitative Information" width="240"/></td>
  6. <td align="center" width="33%"><img src="assets/ei-cover.svg" alt="Envisioning Information" width="240"/></td>
  7. <td align="center" width="33%"><img src="assets/ve-cover.svg" alt="Visual Explanations" width="240"/></td>
  8. </tr>
  9. <tr>
  10. <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>
  11. <td align="center"><b>Envisioning Information</b><br/><i>1990</i><br/><sub>pictures of <b>nouns</b></sub></td>
  12. <td align="center"><b>Visual Explanations</b><br/><i>1997</i><br/><sub>pictures of <b>verbs</b></sub></td>
  13. </tr>
  14. </table>
  15. ---
  16. ## Install
  17. Clone into your Claude Code skills directory:
  18. ```bash
  19. git clone https://github.com/aref-vc/tufte-claude-skill.git ~/.claude/skills/tufte
  20. ```
  21. 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."
  22. To update later:
  23. ```bash
  24. cd ~/.claude/skills/tufte && git pull
  25. ```
  26. To uninstall:
  27. ```bash
  28. rm -rf ~/.claude/skills/tufte
  29. ```
  30. ---
  31. ## The three books, distilled
  32. Tufte gives the three-book taxonomy himself on page 9 of *Visual Explanations*:
  33. - **VDQI** — how to depict data and enforce statistical honesty. The book that gave us *data-ink ratio*, *chartjunk*, *lie factor*, *small multiples*.
  34. - **EI** — how to lay out information in space. Layering, micro/macro readings, color rules, escaping flatland.
  35. - **VE** — how to show motion, causality, narrative. The smallest effective difference, parallelism, visual confections.
  36. Together they yield the ten principles this skill applies.
  37. ### The ten principles
  38. 1. **Show the data.** Above all else. Every other decision asks "does this help the reader see the data?"
  39. 2. **Maximize the data-ink ratio.** Ink that would change if the data changed is data-ink. Everything else is overhead.
  40. 3. **Erase non-data-ink.** Drop the frame box, drop the gridlines, drop the ticks at minor units.
  41. 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.
  42. 5. **Graphical integrity.** Lie factor between 0.95 and 1.05. Bar charts start at zero. Never use area for a 1D quantity.
  43. 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.
  44. 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.
  45. 8. **Micro/macro readings.** Good charts work at two scales: one shape from across the room, every data point legible up close.
  46. 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.
  47. 10. **Word-data integration.** Sparklines belong in sentences. Numbers belong next to their visual. Tables are charts too.
  48. Tufte's own five-line summary from VDQI p.105:
  49. > Above all else show the data.
  50. > Maximize the data-ink ratio.
  51. > Erase non-data-ink.
  52. > Erase redundant data-ink.
  53. > Revise and edit.
  54. ---
  55. ## How the skill works
  56. When you ask Claude to make, design, critique, or improve any chart, the skill activates automatically. It then:
  57. 1. **Reads `principles.md`** to recall the ten rules.
  58. 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.
  59. 3. **Applies `kill-list.md`** — removes the things that don't belong (3D, pie, dual-axis, rainbow scales, frame boxes, redundant legends).
  60. 4. **Produces the chart** in your preferred stack: self-contained HTML/SVG, or React (Recharts + D3).
  61. 5. **Runs `checklist.md`** as a final pass before declaring it done.
  62. Default strictness: Tufte by default, override per chart on request ("I need a pie because the CFO wants one" → comply, but note the alternative).
  63. ---
  64. ## The one-page cheatsheet
  65. 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).
  66. ![One-page Tufte cheatsheet](assets/cheatsheet.png)
  67. ---
  68. ## Before and after
  69. 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:
  70. ### 1. Category comparison — sales by product
  71. ![Before vs after: category comparison](assets/pair-1-category.png)
  72. 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.
  73. ### 2. Time series — monthly active users
  74. ![Before vs after: time series](assets/pair-3-timeseries.png)
  75. 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.
  76. ### 3. Dashboard — four KPIs
  77. ![Before vs after: dashboard](assets/pair-4-dashboard.png)
  78. 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.
  79. ### 4. Period comparison — Q2 vs Q3 by team
  80. ![Before vs after: slopegraph](assets/pair-7-slopegraph.png)
  81. 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.
  82. ### 5. Conversion funnel — signup flow
  83. ![Before vs after: funnel](assets/pair-8-funnel.png)
  84. 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.
  85. ### 6. Cohort retention
  86. ![Before vs after: cohort retention](assets/pair-9-cohort.png)
  87. 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.
  88. 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).
  89. ---
  90. ## When to use the skill
  91. The skill auto-activates on any of these:
  92. - "Make a chart of...", "visualize...", "graph...", "plot..."
  93. - "Build a dashboard for...", "design a KPI tile..."
  94. - "Improve this chart", "critique this visual"
  95. - "What chart should I use for...?"
  96. - Direct invocation: `/tufte` or mentioning Tufte by name
  97. - Any project where chart code is being added or edited
  98. It does *not* activate for:
  99. - Logo design, illustration, or decorative graphics
  100. - Flowcharts, architecture diagrams, hand-drawn sketches
  101. - Pure typography or layout that has no quantitative data
  102. ---
  103. ## How to use the skill
  104. ### Fast path
  105. Just ask. The skill loads automatically and produces a Tufte-compliant chart:
  106. > Make a chart of monthly revenue for the last 12 months
  107. You'll get a sparkline with the current value, two endpoint labels, no frame box, no legend.
  108. ### Stack choice
  109. Tell Claude which output you want:
  110. | Say | You'll get |
  111. |---|---|
  112. | "as inline SVG" or no preference | Self-contained HTML/SVG, single file |
  113. | "in React" or "with Recharts" | Recharts component with Tufte theme |
  114. | "with D3" | D3-in-React (for dot plots, slopegraphs, custom small multiples) |
  115. ### Override the defaults
  116. If you specifically need something on the kill list:
  117. > Make a pie chart of revenue mix — the CFO wants a pie
  118. Claude will produce the pie, but include a one-line comment noting the Tufte alternative (a sorted table). You stay in control.
  119. ### Iterate on an existing chart
  120. Paste your chart code or screenshot and say:
  121. > Apply Tufte to this
  122. Claude will identify violations (frame box, gridlines, gradient fills, redundant legend, wrong sort), and produce a rewritten version.
  123. ---
  124. ## File index
  125. | File | Purpose |
  126. |---|---|
  127. | [`SKILL.md`](./SKILL.md) | Trigger description + skill index (loaded by Claude) |
  128. | [`principles.md`](./principles.md) | The ten rules, with Tufte's exact quotes |
  129. | [`chart-selection.md`](./chart-selection.md) | Data + goal → chart type decision table |
  130. | [`kill-list.md`](./kill-list.md) | What to remove from any chart |
  131. | [`before-after.html`](./before-after.html) | Nine side-by-side comparisons (open in browser) |
  132. | [`checklist.md`](./checklist.md) | 12-item pre-publish check |
  133. | [`cheatsheet.html`](./cheatsheet.html) / [`cheatsheet.pdf`](./cheatsheet.pdf) | One-page printable reference |
  134. | [`presets/html-svg.md`](./presets/html-svg.md) | Style tokens + working SVG templates (sparkline, dot plot, line, small multiples, sparkline-in-table) |
  135. | [`presets/react.md`](./presets/react.md) | Recharts theme + D3-in-React patterns (slopegraph, dot plot, what-to-never-import list) |
  136. ---
  137. ## Requirements
  138. - [Claude Code](https://docs.claude.com/en/docs/claude-code) installed
  139. - Skill auto-loads from `~/.claude/skills/`
  140. - No other dependencies for the skill itself
  141. - The cheatsheet PDF is included, but to regenerate it from the HTML you'll need [`weasyprint`](https://weasyprint.org/) (`pip install weasyprint`)
  142. ---
  143. ## Contributing
  144. Pull requests welcome. Useful additions:
  145. - More before/after pairs (sankey, network, gantt, calendar heatmap, control chart)
  146. - Output presets for other stacks: Python (matplotlib, plotly), Observable Plot, Vega-Lite, ggplot2
  147. - Examples that show Tufte applied to real-world charts you've improved
  148. Open an issue first for anything that adds a new chart type to the decision table — let's discuss the rule before adding it.
  149. ---
  150. ## License
  151. [MIT](./LICENSE). Use it, modify it, ship it.
  152. The skill content is original; quotations from Tufte's books are used under fair-use for educational reference and are attributed inline.
  153. ---
  154. > The principles of information design are universal — like mathematics — and are not tied to unique features of a particular language or culture.
  155. >
  156. > — Edward R. Tufte, *Envisioning Information*, p. 10

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.