8 chapters · 39 min
Skills
Chapter 1 of 8
Design and build data presentations — slide decks, board and investor decks, QBRs, analytics readouts, launch and sales decks, conference talks, and interactive web decks — that…
8 minutes · 1,797 words · 9 sections
A presentation is a data story constrained by a room, a clock, and a person talking over it. Those three constraints change almost every design decision — which is why a deck is not a report with page breaks.
Every content slide’s title is a full-sentence assertion, left-justified, no more than two lines. Not a topic. Not a label.
“Q3 revenue grew 12% on enterprise renewals” — yes. “Q3 Results” — no.
This is the most over-determined rule in the entire field. Six independent traditions arrived at it separately: Alley’s assertion-evidence (28 pt, ≤2 lines, left-justified), Duarte, Reynolds (“write a declarative statement rather than a title”), Doumont (“a complete sentence, with a subject and a verb… no more than 12 words or so”), consulting action titles (“NEVER have a title that is longer than two lines”), and NYT-style claim-titling. Nothing else in the canon has that much agreement behind it.
It also solves problems that look unrelated: the title is the only element that survives being viewed on a phone in Slack; the titles read in sequence are the argument (horizontal logic); and a slide whose title states the conclusion still works when it’s forwarded without you.
Decide how the artifact will be consumed before designing anything. This is the single highest-leverage decision, and getting it wrong is what produces the deck everyone complains about.
| Presented | Sent | Reference | |
|---|---|---|---|
| Condition | Room or screen share, you narrate | Inbox, read once, no narration | Looked up, scanned, quoted |
| Words in content zone | ≤ 20 | ≤ 60 | unbounded |
| Series per chart | ≤ 3 | ≤ 5 | ≤ 8 |
| Elements in content zone | 1 | 1–3 | 3–6 |
| Body floor | 48 px / 24 pt | 28 px / 14 pt | 24 px / 12 pt |
| Title | assertion | assertion | assertion |
The density variable is the reading condition, never the seniority of the audience. An exec deck isn’t sparser because execs are busy; it’s sparser because someone is talking over it.
Two consequences worth stating plainly:
dreambase-data-stories — for the argument. It owns the Big Idea, the pyramid/arc, and audience tiering. This skill owns the slide, the room, and the presenter. When both apply: get the Big Idea and storyline there, then bring them here. When it isn’t available, references/deck-genres.md carries enough storyline structure to work standalone.dreambase-visualization-design — for every chart. Its selection matrix and integrity gate stay in force. This skill adds what it doesn’t cover: legibility at room distance, staged reveals, and one-chart-carries-one-claim.dreambase-echarts — when charts render. Deck-specific animation settings are in references/interactive.md; don’t accept ECharts’ defaults for a deck.dreambase-public-reports — when the audience is external. Its redaction rules govern before anything ships.design.md, .potx, or a brand URL — whenever offered. references/brand-theming.md has the extraction procedure per input type. Absent any brand input, derive a system rather than reaching for defaults.references/deck-genres.md. Write titles only, in order, and read them straight through. If the argument isn’t there in the titles alone, fix it now — no amount of layout rescues a broken storyline.
Then add an archetype column — one per slide, chosen against rule 8 — and read the archetype sequence as a line. Any run of three identical labels is a bug you fix here, in the outline, where it costs nothing. Retrofitting variation after the slides exist never happens.dreambase-visualization-design. Identify the hero chart. Charts that don’t prove a title go to the appendix.references/slide-craft.md for the specs, references/brand-theming.md when brand input exists.references/interactive.md). Default to zero interaction and one build sequence per slide, five steps maximum.references/build-paths.md — the path follows from what the user has and needs, not from a default.references/slide-craft.md, plus the visualization-design integrity gate on every chart.Routed by what the user hands over and how the deck gets used — full decision table and mechanics in references/build-paths.md.
| Situation | Path |
|---|---|
| Live/interactive charts, you control the surface | Self-contained HTML deck (reveal.js + ECharts, inlined, zero network) |
| Must open in PowerPoint; no corporate template | pptxgenjs with real slide masters and placeholders |
Corporate .potx or existing deck supplied | pptx-automizer — author into the actual template |
| Google Slides required | Slides API, within its real limits (no native charts, no SVG, no animation) |
| Static, text-and-image, needs to be tiny | Marp (single-file zero-network by default) |
| Someone else builds it | Storyline + slide-by-slide spec + design system |
Two constraints that decide more than they look like they should: nothing renders live web content inside a PowerPoint or Google Slides slide (Microsoft retired the Web Viewer add-in in December 2024; Slides has no embed element), and no tool converts HTML/CSS into faithful and editable PPTX. So “interactive inside PowerPoint” is always: static slide carrying the full claim, plus a QR/link to the live version, plus the link in the speaker notes — the interactive version is never the only path to the information.
references/deck-genres.md — canonical outlines for board, investor, QBR, readout, launch, sales, all-hands, keynote, and slidedoc, with the metrics each requires and its failure modes. Read first for any new deck.references/slide-craft.md — the numeric system: canvas and the pt↔px bridge, safe areas, grid, type scale, contrast, motion, density, presenter ergonomics, the generated-deck tells, and the pre-ship checklist. Read when designing or reviewing slides.references/interactive.md — the interactive-slideshow model, staged chart reveals and their ethics, ECharts settings for decks, live-data discipline, presenter/remote mechanics, keyboard and a11y. Read for any deck with builds, interaction, or animation.references/build-paths.md — the four build paths with verified mechanics and gotchas: self-contained HTML, pptxgenjs, pptx-automizer, Google Slides API, plus PDF export. Read before building any file.references/brand-theming.md — extracting a design system from a design.md, website, PDF guide, .potx, or a lone logo; deriving an accessible palette from one brand color; light/dark pairs; the brand-safe checklist. Read whenever brand input exists.references/presenters.md — the verified canon (Alley, Duarte, Reynolds, Knaflic, Minto, Zelazny, Tufte and Doumont’s rebuttal, Rosling, Evans, Meeker, Amazon), what the empirical research actually supports, where the authorities genuinely conflict, and the do-not-cite list. Read when justifying a choice or when a stakeholder invokes a name.State the reading condition, genre, and output path up front — they’re design decisions the user needs to see, not implementation details. Deliver the design layer even when the output is plain markdown: layout archetype per slide, type and color intent, what’s a build step, what’s in the notes.
Every chart passes the visualization-design integrity gate. Every deck passes the titles-only read-through and the cold-reader test. Observation, interpretation, and recommendation stay visibly separated — the temptation to blend them is strongest in a room, where nobody can pause to check.
When asked to make the data look better than it is, the honest moves are still available and usually better theatre: a sharper assertion title, a more legible chart, an emphasis build that directs attention to what’s genuinely true. Explain the risk of the rest, and deliver what the data supports.
Install this repository
npx skills add DreambaseAI/skillsSkills install per repository, not per chapter — the CLI has no documented per-skill form, so we do not print one.
Design and build data presentations — slide decks, board and investor decks, QBRs, analytics readouts, launch and sales decks, conference talks, and interactive web decks — that hold up in a room, in an inbox, and on a phone. Use whenever the user wants slides or a presentation: "make a deck", "turn this into slides", "board deck", "pitch deck", "QBR", "readout", "all-hands", "present these results", "PowerPoint", "pptx", "Google Slides", "keynote", "talk", "webinar", "speaker notes", "slidedoc", "reveal.js", or an interactive/HTML deck — even if they only say "put this in slides" or "we're presenting this Thursday". Covers storyline, slide layout and type specs, staged chart reveals, presenter mechanics, accessibility, and the build path (self-contained HTML, .pptx, Google Slides, or a spec). Composes with dreambase-data-stories, dreambase-visualization-design, dreambase-echarts, and any brand guide, design.md, or .potx the user supplies.
The verbatim description from this skill’s front matter — the string an agent matches on to decide whether to load it.
main, last pushed 5 August 2026.SKILL.md, not by matching a directory convention. One layout observed: skills/*/SKILL.md.h1 and no skipped levels:/DreambaseAI/skills.md, and each chapter at its own .md URL.7 files · 99 KB
Everything this skill ships beside its prose. All of it is set here, as subchapters of chapter 1.
Documentation the agent loads on demand, rather than up front.
Everything else published alongside the skill.