agentsclimarketplace

Tufte analytical design

Skill jpoindexter/tufte-skills/skills/tufte-analytical-design

27 reference-grade Claude Code skills extracting Edward Tufte's visual design principles from all 5 books — data-ink ratio, Lie Factor, chartjunk, small multiples, sparklines, analytical design, and more

Install
npx -y skills add jpoindexter/tufte-skills --skill tufte-analytical-design

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
  • 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

The six principles of analytical design from Beautiful Evidence — how to build evidence presentations that assist reasoning rather than decorate reports, why those principles are universal (from the first stone map to any future display), and how to distinguish analytical from decorative design.

SKILL.md

24.6 KB, ~5.4k tokens by cl100k_base, as published. Nobody here has run it

Tufte: Principles of Analytical Design

Overview

Analytical design is design in service of reasoning. Tufte's six principles, derived from Minard's 1869 map of Napoleon's Russian campaign, define what separates displays that assist thinking from those that merely perform it. The core claim: design principles are not arbitrary aesthetic choices — they are derived directly from the cognitive tasks required to reason about evidence. A presentation that violates these principles is not just ugly; it impairs thinking.

Naming convention: Failure-mode labels in this skill (Floating Fact, Forced Flatland, Mode Segregation, etc.) are descriptive teaching names, not Tufte's own terminology. Only quotes and page-cited phrasings reflect his exact words. Use the labels for diagnosis; don't attribute them to Tufte.


§1. The Grand Principle: Design Follows Thinking

The source of all six principles is one meta-principle:

"The principles of analytical design are derived from the principles of analytical thinking." — Tufte, Beautiful Evidence, p. 137

Cognitive tasks drive design decisions. If the intellectual task is comparison, show comparisons. If the task is causal reasoning, show causal structure. This is not a metaphor — it is the literal derivation rule for every choice in information display.

Consequence for practice: Before any design decision, name the intellectual task. The design choice follows from that, not from brand guidelines, template defaults, or what looks impressive. Tufte prescribes that every design process begin by naming the task the display must serve: what does a reader need to do with this information? That question drives which elements to include, how to structure them, and which technologies to employ.

Why the principles are universal (pp. 137–139)

The principles are not tied to a medium, a tool, or an era. Because they come from how humans reason rather than from any technology, they hold across the entire history of evidence display:

  • Across time: the same rules govern the earliest known maps — scratched into stone roughly 6,000 years ago — and paper, print, screens, and whatever comes next. Tufte's claim is that a principle derived from analytical thinking cannot expire when the production technology changes.
  • Across minds: the principles would apply even to a hypothetical non-human or alien intelligence presenting evidence, because any reasoning agent must still compare, explain causality, handle many variables, integrate modes, document, and care about content.
  • Producer/consumer symmetry: the same principles bind the maker of a display and its reader — both are doing the same reasoning. As Tufte puts it, on questions of analytical quality, "we're all in it together." There is no separate, lower standard for "just presenting."

Practical upshot: never excuse a weak display with "it's only a slide / a dashboard / a draft." The standard is set by the reasoning task, which is identical regardless of tool or audience.

Analytical vs. Decorative Design

DimensionAnalytical DesignDecorative / Presentation Design
First question"What content tasks must this display help with?""How can this presentation look good?"
Evidence modesIntegrates words, numbers, images freelySegregates modes into slides, tables, figures
Multivariate depthShows 6+ variables simultaneously when data demandsStrips to 1–2 variables for "clarity"
ComparisonMakes comparisons explicit and visibleLeaves comparisons implicit or verbal
CausalityShows mechanism, not just correlationShows effects without agents or causes
DocumentationNames authors, sources, scales, assumptionsOmits provenance; sources buried in footnotes
Driving forceContent — the substance being explainedProduction technology, templates, brand
Test of successDoes it assist thinking about the evidence?Does it look polished and professional?

§2. The Six Principles

Two epigraphs that frame the principles (p. 122)

Tufte opens the principles with two quotations that set up the whole chapter:

  • Durkheim, on the categories of understanding. Durkheim held that human reasoning rests on a small set of fundamental categories — among them time, space, number, and cause. Tufte's point: these are exactly the native categories analytical design must serve. The six principles are, in effect, instructions for displaying time, space, number, and cause well.
  • Matisse, on difference. > "I do not paint things, I paint only the differences between things." — Matisse. This frames Principle 1: the unit of meaning is the contrast, not the isolated object. A display communicates by showing differences.

These two anchors map onto the principles: Durkheim's categories say what to show (number, time, space, cause); Matisse says how meaning arises (through comparison).


Principle 1: Comparisons (p. 127)

State it as: make comparisons, contrasts, and differences explicit and visible.

The central question of all statistical reasoning is: compared with what? Across every form of statistical work — time series, regression, experiment design, database analysis — the central act is answering that question. Every analytical method is, at bottom, a comparison method. The display must make the comparison visible, not leave it implicit.

Minard at the Niemen — read the ratios carefully:

  • Survival ratio: ~1 in 42 — about 10,000 of the 422,000 who crossed into Russia returned (10,000 ÷ 422,000 ≈ 1/42).
  • As actually drawn: Tufte notes (p. 127) the two band widths at the Niemen were drawn in a ratio of roughly 1 in 28, not a strict 1-in-42. The graphic encoding is approximate at that crossing, not perfectly proportional. Don't claim the line widths literally are the 1:42 survival ratio — the survival ratio is the fact; ~1:28 is what the ink shows.

Either way, the width of two lines communicates a six-month, hundreds-of-miles catastrophe that no single number conveys.

Do / Don't pairs:

DoDon't
Show before/after states in the same visual fieldShow only the current state without baseline
Provide a reference class or control conditionReport absolute numbers without context
Let scale encode magnitude of differenceUse color alone to signal "different"
Use small multiples for sequence comparisonsAnimate sequentially so no two states are visible at once
Place comparanda adjacent or overlappingSeparate comparanda across slides or pages

Failure mode — Floating Fact: a number presented with no comparison reference ("sales were $4.2M"). The reader can't assess significance, trend, or deviation because the baseline was never provided.


Principle 2: Causality, Mechanism, Structure, Explanation (p. 128)

State it as: show causality, mechanism, explanation, and systematic structure.

Causal thinking is not optional in serious analytical work. Scientific inquiry is structured by causal laws; medical reasoning about prevention, diagnosis, and intervention requires causal models; policy and reform require knowing which causes to govern — policy decisions are causal decisions about which lever to pull. Displays that show only effects, without causes, cannot support the reasoning they exist to enable.

Minard's temperature graph along the bottom of the map is the causal argument: cold explains why men died during the retreat, not merely that they died. The map gives location; the temperature curve gives mechanism.

Do / Don't pairs:

DoDon't
Show agents (who or what acts) with arrows or flow linesUse passive-voice structures that suppress the agent
Include the causal variable even if it adds complexityStrip to the dependent variable only, for "simplicity"
Draw causal diagrams: A → B → CShow outcomes with no link between them
Distinguish correlation from mechanism explicitlyImply causation from co-occurrence
Name the mechanism in the title or annotationLeave causation buried in the verbal text

Failure mode — Effects Without Causes: a display reports outcomes — what happened — with no agent, mechanism, or sequence. Location without cause; result without actor. The reader cannot reason about what to do because there is no causal model to act on. (For the specific corruption-chapter cases — agentless strategic-plan bullet lists and anti-causal statistics — see §7.)


Principle 3: Multivariate Analysis (p. 130)

State it as: show multivariate data — more than one or two variables at once.

Minard's single map encodes 6 variables: army size (band width), geographic position (2 dimensions, x and y), direction of march, temperature, and date. None of the interesting worlds — physical, biological, human — is bivariate. Reducing to 1 or 2 variables to fit a format is not simplicity; it falsifies the subject's actual complexity.

Two-dimensionality is a constraint of the medium, not of the subject. Presentation technology that enforces flatness trains analysts to think flatly. Because real phenomena are inherently multivariate, showing multiple variables at once should be the default — unremarkable, expected, routine — not a special achievement.

Techniques for escaping flatland:

  • Layering and separation (transparent overlays, cartographic layering)
  • Small multiples (one panel per condition, all visible in one view)
  • Encoding extra variables in size, texture, shape, annotation
  • Integrating text and numbers directly into graphics
  • Narrative flow-lines that carry several variables simultaneously

Do / Don't pairs:

DoDon't
Ask how many variables the phenomenon actually hasDefault to a 2-axis chart without examining dimensionality
Use small multiples to add a 3rd or 4th variableAnimate to add a variable (animation hides comparisons)
Annotate data points with words that carry more dataPush extra variables into a legend that must be decoded
Show 6 variables in one display when content demandsSlice into 6 slides, each showing 1 variable

Concrete benchmark (from the source): physical and biological science journals (Nature, Science) publish statistical graphics with a median of more than 1,000 numbers; applied medical research (The Lancet) averages about 45 numbers per graphic. High numeric density is the scientific norm; the low end is a presentation convention, not a content requirement.

Failure mode — Forced Flatland: an inherently multivariate phenomenon (6+ variables) shown with only 1–2, so the appearance of simplicity conceals the real complexity. The reader can't assess fit, variability, outliers, or alternative explanations from the exposed slice alone. (Descriptive label — Tufte's own term for the flat-medium problem is "flatland.")


Principle 4: Integration of Evidence (p. 131)

State it as: completely integrate words, numbers, images, and diagrams.

The evidence doesn't care what mode it arrives in. Segregating it by mode — all images in one section, all tables in an appendix, all text in the body — is organizational convenience that actively impairs reasoning. Maps, the best practice in analytical display, have always integrated multiple modes on a single surface. The distinctions between evidence types matter far less than their combined bearing on the question being investigated, so modes must be assembled where the evidence is needed, not where the production system finds them convenient.

Minard integrates a paragraph of words (title, legend, assumptions), a geographic map (spatial position), flow-lines (army size and direction), temperature data (cause), dates (time), and place names (context) — all within one 25 × 21 inch surface.

Galileo's annotated telescope drawings (1610) show the same move: he wrote observation time, satellite identity, and distance (in Jovian radii) directly onto each sketch, turning still drawings into credible quantitative evidence about satellite motion rather than mere pictures of what the telescope showed.

Do / Don't pairs:

DoDon't
Place labels directly on data points — words are evidenceUse letter codes keyed to a separate legend
Put the explanatory text with the graphic it explainsCollect figures into a "Figures" section at the back
Annotate a chart with the model equation that fits itDescribe the model in text, show the chart elsewhere
Use sparklines to embed data-lines inline with proseWrite "[see Figure 3]" and break the reading
Show the unmapped and mapped image in sequenceForce the reader to cross-reference between pages

Failure mode — Mode Segregation: a report of all words, with tables appended at the back and images in an exhibit section. The reader must hold evidence from three locations in memory at once; the architecture fights comprehension.

Failure mode — Single-mode Research: an investigation that relies on exactly one kind of evidence (only statistics, or only memoirs, or only economic models) when the subject demands several. The question degrades from "how can this be explained?" to "how can one type of information explain this?"


Principle 5: Documentation (p. 133)

State it as: thoroughly describe the evidence — detailed title, authors and sponsors, data sources, complete measurement scales, and the relevant caveats.

Documentation is quality control, not formality. Undocumented displays are inherently suspect; the presence of documentation signals that someone is taking responsibility for the analysis.

Minard's 1869 map documents all of this on the face of the display:

Documentation itemMinard's answer
What is it about?Losses in men of the French Army in the Russian campaign, 1812–1813
Who did the work?Drawn up by M. Minard
Who is that?Inspector General of Bridges and Roads, retired
Where and when?Paris, 20 November 1869
Data sources?5 named sources (Thiers, Ségur, Fézensac, Chambray, and Jacob's diary)
Assumptions?Troops of Prince Jérôme and Marshal Davout assumed always with the army
Scale (flow-lines)?1 millimeter = 10,000 men
Scale (map)?Common leagues of France (Map of Fézensac)
Scale (temperature)?Degrees of the Réaumur thermometer below zero
Publisher?Named printer and publisher

Benchmark (from the source): in 13 computer-science books on technical visualizations, only 20% of images had complete scales and labels, and 60% had no scales or labeled dimensions at all. Hubble Space Telescope public images are typically published with no indication of distance, size, or location.

Do / Don't pairs:

DoDon't
Name the author(s) — people, not agenciesSign it "Marketing Department" or leave it unsigned
Name every data source explicitlyWrite "data from internal records"
Show at least one measurement scale on every graphicLeave the axis scale implied or omitted
State assumptions and their implicationsBury assumptions in a methodology appendix
Disclose sponsorship and conflicts of interestPresent findings as neutral with no funder named
Date the displayPresent it with no temporal context

Failure mode — Anonymous Authorship: corporate and government reports with no named individual author. The absence of names signals evasion of responsibility: when things go wrong, no one is findable. (For undefined units, gamed base years, and time-shifted numbers — corrupt measurement — see §7.)


Principle 6: Content Counts Most of All (p. 136)

State it as: analytical presentations ultimately stand or fall on the quality, relevance, and integrity of their content.

This is the supremacy principle; it overrides the other five. No design technique, visual treatment, or technology can salvage a presentation built on weak, irrelevant, or corrupt content. Conversely, content important enough will be heard even through bad design. Minard's work, Tufte notes, exemplifies the spirit behind excellent analytical graphics: deep knowledge of the subject and genuine caring about the substance.

Minard never names Napoleon on a map of Napoleon's own march — a design choice that reinforces the content priority: memorialize the dead, don't celebrate the surviving celebrity.

The most direct route to a better presentation is therefore stronger content, not a better visual container.

Do / Don't pairs:

DoDon't
Ask "is this worth showing at all?" before designingBuild the visual container before confirming the content earns it
Start from the substantive question to be answeredStart from the slide template or visual system
Cut content not directly relevant to the questionPad with tangential data to look thorough
Know the subject deeply — content drives designDelegate content selection to non-experts
Judge the design by whether it aids reasoningJudge it by polish or technical sophistication

Failure mode — Chartjunk as Substitute: decorative graphics, 3D extrusion, gradient fills, gratuitous color — visual elaboration that signals effort without adding evidence. The decoration is performing in place of the content.

Failure mode — Technology-Driven Presentation: choosing the display architecture from what the software supports ("how can this presentation use [the latest display technology]?") instead of what the evidence requires. The content question always comes first.


§3. The Analytical vs. Decorative Distinction in Practice

Analytical design is the design of evidence presentations — scientific reports, dashboards, policy briefs, technical manuals, financial disclosures. Decorative / presentation design is the design of communications meant to persuade, brand, or market. They are not mutually exclusive, but their first principles differ:

Analytical DesignDecorative / Presentation Design
Audience taskReasoning about evidenceReceiving a message or impression
Success criterionAccurate, efficient inferencePersuasion, recall, aesthetic response
First questionWhat intellectual task must this support?What impression should this convey?
Treatment of complexityShow it — complexity is the subjectReduce it — complexity fatigues the audience
Treatment of uncertaintyShow it — error bars, intervals, alternativesSuppress it — uncertainty weakens the message
Integration of modesRequired — evidence crosses all modesOptional — visual consistency dominates
DocumentationRequired — credibility depends on itOptional or counterproductive (disrupts flow)

The core test: would a skeptical expert, given only the display, be able to assess the quality, provenance, and completeness of the evidence? Analytical design passes this test. Presentation design is not built for it.


§4. Minard's Map as Reference Implementation

Charles Joseph Minard's 1869 Carte Figurative of Napoleon's Russian campaign is Tufte's primary exemplar because it satisfies all six principles at once in a single 25 × 21 inch display:

PrincipleHow Minard satisfies it
1. Comparisons422,000 entering vs. ~10,000 returning — survival ratio ≈ 1:42 (bands as drawn at the Niemen ≈ 1:28, p. 127); the Berezina crossing collapses ~50,000 to ~28,000
2. CausalityTemperature curve along the bottom, each point dated; cold explains deaths during the retreat
3. Multivariate6 variables: army size, geography (x, y), direction, temperature, date — all in one image
4. IntegrationWords (title, legend, annotations), numbers (troop counts at each location), flow-map diagram, temperature graphic, geographic map — fully fused
5. DocumentationAuthor, role, place, date, 5 named sources, 3 measurement scales, stated assumptions
6. ContentAn anti-war image — Minard cared about the dead; the word "Napoleon" never appears

Flow-line scale: 1 millimeter = 10,000 men — the one number needed to read the whole map quantitatively. Note the distinction from §2: the survival ratio is ~1:42; the drawn band widths at the Niemen are ~1:28. The encoding is approximate there, not perfectly proportional.


§5. Failure Modes Catalog

Source column distinguishes the analytical-design chapter (pp. 122–139) from the adjacent corruption chapter (pp. 140–145, see §7).

Failure ModePrinciple ViolatedSourceDiagnostic Signal
Floating Fact1 Comparisons122–139A number with no baseline, context, or reference
Effects Without Causes2 Causality122–139Outcomes with no agent, mechanism, or sequence
Forced Flatland3 Multivariate122–1391–2 variables shown for a 6-variable phenomenon
Mode Segregation4 Integration122–139Tables in an appendix; "see Figure 3" in the text
Single-mode Research4 Integration122–139Only one evidence type for a multi-mode subject
Anonymous Authorship5 Documentation122–139No author, sources, scale, or date
Chartjunk as Substitute6 Content122–139Visual elaboration rising as content weakens
Technology-Driven6 Content122–139Design chosen by tool capability, not by evidence
Agentless Effects (strategic-plan bullets, passive voice)2 Causality140–145"Accelerate Revenue Recognition!" with no actor or mechanism
Anti-causal Statistics2 Causality140–145Data mining / factor analysis offered as explanation
Corrupt Measurement5 Documentation140–145Gamed base years, time-shifted or unadjusted numbers

§6. Application Checklist

Before shipping any analytical display, verify each principle:

  • Comparisons: What is this explicitly compared to? Is the reference visible in the display?
  • Causality: Does it show mechanism, or only correlation/co-occurrence? Are agents named?
  • Multivariate: How many variables does the phenomenon actually have? Are fewer shown — and why?
  • Integration: Are words, numbers, images, diagrams assembled where the evidence is needed, or segregated by mode?
  • Documentation: Are author(s), sources, scales, date, and material assumptions visible on the display itself?
  • Content: Would a skeptical expert find the content substantively adequate? Is this worth showing at all?
  • Universality: Have you excused weakness with "it's only a slide/dashboard"? The standard is set by the reasoning task, not the tool (§1).

§7. Corruption in Evidence Presentations (adjacent chapter, pp. 140–145)

These cases come from the chapter that follows the six principles, not from the principles chapter itself. They are included because each is a canonical, real-world inversion of a specific principle — useful for diagnosis, but cite them to pp. 140–145, not to the principle's own page.

CorruptionInvertsDiagnostic signal
Agentless effects2 CausalityBullet-list strategic plans ("Accelerate Revenue Recognition!") and passive-voice prose (e.g. the 9/11 Commission style) assert outcomes with no actor, action, mechanism, or sequence. Identical-looking bullets can hide radically different causal structures, so the display can't help anyone decide what to do.
Anti-causal statistics2 CausalityData mining, factor analysis, and multidimensional scaling crunch a data matrix without testing any causal model — a pile of effects with no causes behind them. Fine for exploration; dangerous when presented as explanation.
Corrupt measurement5 DocumentationUndefined or imprecise units, tendentiously chosen base years, time-shifting of data (e.g. premature revenue recognition), and inflation-unadjusted money. These are documentation failures before they are dishonesty — the scale, timing, or definition is undisclosed or gamed.

Rule of thumb: corruption is what principle-violation looks like once incentive enters. The fix is the same as the principle's fix — name the agent, test the model, disclose the scale — applied against someone who benefits from the fog.

Source book: /tmp/tufte/beautiful-evidence.pdf Read pages: "9-45,122-145" (Read in chunks of ≤20 pages if the range is large)

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.