Slides
Make a deck people remember: half the slides, half the text, one idea each,
huge type, real proof. Build it as HTML, check it with a script, export it.
Use it for a new talk, pitch or launch deck, an old deck that is too long,
or a deck that must also exist as PPTX or Google Slides. For a demo video use
ship-demo-video; for a brand direction use brand-router.
The rules
These are the owner's rules. All of them apply to every deck.
- Half the slides, half the text. An old deck is the content source, not
the model. Cut it to half the slides, then cut each slide's words in half.
- One focus per slide. One idea, one visual, one line. Two ideas make two
slides, or one goes.
- Big type. On the 1920×1080 stage: headline ≥96 px, body ≥44 px, nothing
under 32 px. At most 12 headline words and 20 other words per slide.
- Hooks. Bold, contradictory, quotable, viral: "Your AI remembers
everything. Except you." Every fact in it is true and in
SOURCES.md.
- No chrome. No header, footer, page counter or logo strip.
- A new layout on every slide. No two slides in a row share a layout.
Pick from the layout catalogue.
- Visuals over text. Draw before you write. Use at least two figures from
the anatomy skill (https://skills.wheresryan.sh/anatomy,
npx skills add wheresryan22/anatomy), designed for this deck's idea.
- Impeccable pass. Run every slide through the impeccable skill
(https://impeccable.style) and
npx impeccable detect. Fix the findings.
- Light and dark. One page, two themes. Both must look designed, not
inverted.
- Social proof and pop culture. Find real posts and complaints by known
people, verify each, and render them as quote cards. Never invent a quote.
See social proof.
- One product per deck. When a deck tries to cover many things, split
it: one deck per product, each with its own hook.
- Look at every slide. Render every slide in both themes and read every
PNG before you call it done.
Before you start
- Node 20+,
npm i playwright and npx playwright install firefox.
- For PPTX:
python-pptx in a venv, or pptxgenjs. For Slides: gog, signed in.
- Fonts as files next to the page, loaded with
@font-face. No remote fonts.
- Ask the owner before you upload to Drive or share a link.
Workflow
1. Find the one point
Write the deck's point in one sentence. Write the action you want at the end.
If the material covers several products, stop and propose one deck per product.
2. Gather proof
Every number and claim gets a line in SOURCES.md with an id (S1) and a
primary link. Run the social proof research step;
quotes get ids (Q1) and the word VERIFIED. Drop any claim you cannot source.
3. Outline on paper
Write one line per slide: its hook, its layout and its visual. Check that the
list is half the old deck, one idea per line, a new layout on each line, with
at least two anatomy figures and one quote card.
4. Build the page
Copy assets/stage.html to index.html. It has a
1920×1080 stage scaled to fit, arrow keys, Space, Home, End and click to move,
#n to open slide n, and ?theme=light|dark or the t key for the theme.
Keep these conventions; the pre-flight reads them:
<section class="slide" data-layout="<name>"> for each slide.
<h1> for the headline. Other text is body.
data-src="S3" on any element that makes a claim.
<figure class="quote" data-src="Q2"> for a quote card.
data-export="image" on anything the PPTX should carry as a picture.
Build anatomy figures with the kit in both themes. Inline the SVG or iframe it.
5. Impeccable pass
For each slide, check type scale, hierarchy, spacing, colour and the refuse
list from impeccable's craft floor. Run the detector. Note what you changed.
6. Pre-flight
Copy scripts/check-deck.mjs into a folder with
Playwright installed and run node check-deck.mjs <deck-dir>. It renders
shots/{dark,light}/sN.png and exits 1 on any of these:
| Check |
Rule |
| Words |
Headline ≤12, other text ≤20 per slide |
| Font size |
Headline ≥96 px, largest body text ≥44 px, all text ≥32 px |
| Layout |
Every slide has data-layout; none repeats the previous one |
| Chrome |
No header, footer, nav, .page-number, .counter, .logo-strip |
| Overflow |
Nothing crosses the stage edge |
| Contrast |
Body ≥4.5:1, headline ≥3:1, against the nearest solid background, in both themes |
| Sources |
Every data-src id has a line in SOURCES.md |
| Quotes |
Every quote card's line in SOURCES.md says VERIFIED |
Exit 0 means it passed. Then open every PNG in both themes. Look for
clipping, collisions, a figure that reads wrong, an inverted-looking theme, and
text over images or gradients (the contrast check skips those). Read each hook
aloud: would someone quote it, and is it still true?
7. Export
Follow the export guide: extract text boxes from the
live page, build deck-dark.pptx and deck-light.pptx with native text
(python-pptx or PptxGenJS) and figures as cropped images, render them back to
compare, then, with approval, gog drive upload <file> --convert-to slides.
Hand back
index.html with assets and fonts, shots/{dark,light}/sN.png,
deck-dark.pptx, deck-light.pptx, Slides links if uploaded, SOURCES.md,
social.md, and a report: each slide's focus, the impeccable changes, the
pre-flight output, and what is still weak.
Failure modes
- The old deck, shorter. Same outline, fewer words. Start from the point.
- A false hook. A viral line with a bent number. Cut it.
- A paraphrase in quote marks. Copy the words or drop the quote.
- A PPTX of screenshots. The owner cannot edit it. Text stays text.
- Shots never read. The script passed, but a figure clips.
Resources
Resources lists the tools, frameworks, methods and
books behind these rules, each with what to take from it.
1---2name: slides3description: Build a talk or pitch deck as one HTML page on a 1920×1080 stage, with big type, one idea per slide, a new layout on every slide, anatomy figures, verified social-proof quote cards, and designed light and dark themes. Then export editable PPTX (python-pptx or PptxGenJS) and Google Slides (gog Drive upload with conversion). Ships a stage template and a pre-flight script that renders every slide in both themes and checks word counts, font sizes, layout repeats, contrast, sources and quotes. Use when asked to make, shrink, restyle or export slides, a deck, a keynote or a presentation.4user-invocable: true5argument-hint: "[topic, old deck path, or product] (optional)"6metadata:7 source: https://skillmd.com/skills/pooriaarab/slides8---910# Slides1112Make a deck people remember: half the slides, half the text, one idea each,13huge type, real proof. Build it as HTML, check it with a script, export it.1415Use it for a new talk, pitch or launch deck, an old deck that is too long,16or a deck that must also exist as PPTX or Google Slides. For a demo video use17`ship-demo-video`; for a brand direction use `brand-router`.1819## The rules2021These are the owner's rules. All of them apply to every deck.22231. **Half the slides, half the text.** An old deck is the content source, not24 the model. Cut it to half the slides, then cut each slide's words in half.252. **One focus per slide.** One idea, one visual, one line. Two ideas make two26 slides, or one goes.273. **Big type.** On the 1920×1080 stage: headline ≥96 px, body ≥44 px, nothing28 under 32 px. At most 12 headline words and 20 other words per slide.294. **Hooks.** Bold, contradictory, quotable, viral: "Your AI remembers30 everything. Except you." Every fact in it is true and in `SOURCES.md`.315. **No chrome.** No header, footer, page counter or logo strip.326. **A new layout on every slide.** No two slides in a row share a layout.33 Pick from [the layout catalogue](references/layouts.md).347. **Visuals over text.** Draw before you write. Use at least two figures from35 the anatomy skill (https://skills.wheresryan.sh/anatomy,36 `npx skills add wheresryan22/anatomy`), designed for this deck's idea.378. **Impeccable pass.** Run every slide through the impeccable skill38 (https://impeccable.style) and `npx impeccable detect`. Fix the findings.399. **Light and dark.** One page, two themes. Both must look designed, not40 inverted.4110. **Social proof and pop culture.** Find real posts and complaints by known42 people, verify each, and render them as quote cards. Never invent a quote.43 See [social proof](references/social-proof.md).4411. **One product per deck.** When a deck tries to cover many things, split45 it: one deck per product, each with its own hook.4612. **Look at every slide.** Render every slide in both themes and read every47 PNG before you call it done.4849## Before you start5051- Node 20+, `npm i playwright` and `npx playwright install firefox`.52- For PPTX: `python-pptx` in a venv, or `pptxgenjs`. For Slides: `gog`, signed in.53- Fonts as files next to the page, loaded with `@font-face`. No remote fonts.54- Ask the owner before you upload to Drive or share a link.5556## Workflow5758### 1. Find the one point5960Write the deck's point in one sentence. Write the action you want at the end.61If the material covers several products, stop and propose one deck per product.6263### 2. Gather proof6465Every number and claim gets a line in `SOURCES.md` with an id (`S1`) and a66primary link. Run the [social proof research step](references/social-proof.md);67quotes get ids (`Q1`) and the word VERIFIED. Drop any claim you cannot source.6869### 3. Outline on paper7071Write one line per slide: its hook, its layout and its visual. Check that the72list is half the old deck, one idea per line, a new layout on each line, with73at least two anatomy figures and one quote card.7475### 4. Build the page7677Copy [`assets/stage.html`](assets/stage.html) to `index.html`. It has a781920×1080 stage scaled to fit, arrow keys, Space, Home, End and click to move,79`#n` to open slide n, and `?theme=light|dark` or the `t` key for the theme.80Keep these conventions; the pre-flight reads them:8182- `<section class="slide" data-layout="<name>">` for each slide.83- `<h1>` for the headline. Other text is body.84- `data-src="S3"` on any element that makes a claim.85- `<figure class="quote" data-src="Q2">` for a quote card.86- `data-export="image"` on anything the PPTX should carry as a picture.8788Build anatomy figures with the kit in both themes. Inline the SVG or iframe it.8990### 5. Impeccable pass9192For each slide, check type scale, hierarchy, spacing, colour and the refuse93list from impeccable's craft floor. Run the detector. Note what you changed.9495### 6. Pre-flight9697Copy [`scripts/check-deck.mjs`](scripts/check-deck.mjs) into a folder with98Playwright installed and run `node check-deck.mjs <deck-dir>`. It renders99`shots/{dark,light}/sN.png` and exits 1 on any of these:100101| Check | Rule |102|---|---|103| Words | Headline ≤12, other text ≤20 per slide |104| Font size | Headline ≥96 px, largest body text ≥44 px, all text ≥32 px |105| Layout | Every slide has `data-layout`; none repeats the previous one |106| Chrome | No `header`, `footer`, `nav`, `.page-number`, `.counter`, `.logo-strip` |107| Overflow | Nothing crosses the stage edge |108| Contrast | Body ≥4.5:1, headline ≥3:1, against the nearest solid background, in both themes |109| Sources | Every `data-src` id has a line in `SOURCES.md` |110| Quotes | Every quote card's line in `SOURCES.md` says VERIFIED |111112Exit 0 means it passed. Then open every PNG in both themes. Look for113clipping, collisions, a figure that reads wrong, an inverted-looking theme, and114text over images or gradients (the contrast check skips those). Read each hook115aloud: would someone quote it, and is it still true?116117### 7. Export118119Follow [the export guide](references/export.md): extract text boxes from the120live page, build `deck-dark.pptx` and `deck-light.pptx` with native text121(python-pptx or PptxGenJS) and figures as cropped images, render them back to122compare, then, with approval, `gog drive upload <file> --convert-to slides`.123124## Hand back125126`index.html` with assets and fonts, `shots/{dark,light}/sN.png`,127`deck-dark.pptx`, `deck-light.pptx`, Slides links if uploaded, `SOURCES.md`,128`social.md`, and a report: each slide's focus, the impeccable changes, the129pre-flight output, and what is still weak.130131## Failure modes132133- **The old deck, shorter.** Same outline, fewer words. Start from the point.134- **A false hook.** A viral line with a bent number. Cut it.135- **A paraphrase in quote marks.** Copy the words or drop the quote.136- **A PPTX of screenshots.** The owner cannot edit it. Text stays text.137- **Shots never read.** The script passed, but a figure clips.138139## Resources140141[Resources](references/resources.md) lists the tools, frameworks, methods and142books behind these rules, each with what to take from it.