talk-writing
Core Philosophy
A conference keynote or technical presentation is not an academic lecture, nor is it a live reading of 40 text-heavy PowerPoint slides. A talk is live performance theater designed to plant a single unforgettable thesis into the audience's minds. Delivering a great talk requires a relentless Through-Line, respecting strict word-count timing constraints (130 words per minute), scripting the visual interplay between speaker and screen, and practicing an opening hook that grabs attention within 30 seconds.
4-Step Conference Presentation & Keynote Pipeline
Step 1: The Through-Line (The Single Idea)
- The One-Sentence Rule:
- Every talk must have exactly one through-line:
- Example: "Compilers are not mysterious black boxes; they are simple state machines that every engineer can inspect and optimize."
- If a slide or story does not directly advance the through-line, delete it without mercy.
- The 3 Core Audience Questions:
- Why this? (Why does this topic matter right now?)
- Why you? (What unique failure or data gives you authority to speak?)
- Why me? (How does the attendee's daily work change tomorrow because of this talk?)
Step 2: Timing & Word Count Budgeting
- The 130 Words-Per-Minute Constant:
- Conversational speaking pace on stage is strictly 120–140 words per minute.
- Standard Presentation Time Budgets:
- 10-Minute Lightning Talk: 1,200 words max.
- 20-Minute Standard Tech Talk: 2,500 words max.
- 45-Minute Keynote: 5,500 words max.
- Going over your scheduled time is the ultimate cardinal sin of public speaking; it disrespects the organizers, the attendees, and the speakers following you.
Step 3: Slide Deck Choreography (One Idea Per Slide)
- The Screen is Your Backdrop, Not Your Teleprompter:
- Slides should contain minimal text (target: $\le 6$ words per slide).
- Use slides for visual punchlines, architecture diagrams, large readable code snippets (24pt font minimum), and high-contrast terminal captures.
- The Speaker vs Screen Dance:
- Never turn around and read your slides with your back to the audience.
Step 4: The Scripting & Opening Hook Architecture
- The First 30 Seconds:
- Never begin with throat-clearing: "Hi everyone, thank you for coming, can you hear me okay, my name is Dave and today I'm going to talk about..."
- Start directly inside the action or the controversy:
- "At 2:14 AM on Christmas Eve, our production database dropped 40 million customer accounts. And I was the one who ran the script."
- The Call to Action (The Final Resonance):
- End on a high, inspiring, actionable note that gives the audience a homework assignment for Monday morning.
Deliverable Format: Keynote Script & Slide Plan (KEYNOTE-SCRIPT.md)
# Conference Talk Script & Slide Plan: [Talk Title]
*Event: [Conference Name] | Duration: 20 Minutes (Target: 2,500 words)*
*The Through-Line: [Single sentence thesis]*
## 1. Slide & Script Choreography
### [Slide 1: Plain Black Screen with Blood-Red Text: "02:14 AM"]
**Spoken Voiceover (Time: 0:00 - 0:45 | 100 words)**:
At 2:14 AM on Christmas Eve, my phone buzzed. Then it buzzed again. By 2:16, sixteen engineers were on a frantic Zoom bridge staring at an empty AWS RDS console. 40 million records gone.
Most post-mortems blame human error. Today, I'm going to prove to you that human error is a myth—and that our database tooling was actively engineered to deceive us.
---
### [Slide 2: Architecture Diagram — The Illusion of High Availability]
**Spoken Voiceover (Time: 0:45 - 2:30 | 220 words)**:
Let's look at what we thought we built. On paper, it was textbook elegance: multi-region active-passive replication with automated failover... [Continue technical breakdown]
---
### [Slide 3: Big Code Snippet: 3 Lines of Rust]
**Spoken Voiceover (Time: 2:30 - 4:00 | 195 words)**:
Here is the bug. Notice line 42. It looks innocent, doesn't it? But under heavy concurrent load...
## 2. Rehearsal Timing Verification
- [ ] Total word count: 2,420 words (Target: 2,500 words).
- [ ] Practice run 1: 18 minutes, 40 seconds.
- [ ] Code snippet slides tested for readability from 50 feet away (32pt font).
Worked Example: 20-Minute Technical Keynote
- Topic: "Debugging Production Distributed Traces".
- Execution: Scripted to exactly 2,450 words across 28 visual slides. Opened with a 15-second personal outage story.
- Outcome: Delivered in 19 minutes, 15 seconds; ranked #1 speaker out of 42 presenters at the annual developer conference.
Verification Checklist
Anti-Patterns
- Wall-of-Text Slides: Putting 8 bullet points of 14pt text on a slide and reading them verbatim.
- Overrunning Time: Speaking for 28 minutes in a 20-minute slot until the organizers cut your microphone.
- The Apologetic Intro: Spending the first 2 minutes apologizing for being nervous or complaining about slide formatting.
1---2name: talk-writing3description: Write a conference talk or keynote: through-line, one idea per slide, opening hook and honest timing. Use when scripting keynote talks, conference presentations, or lightning talks.4---56# talk-writing78## Core Philosophy9A conference keynote or technical presentation is not an academic lecture, nor is it a live reading of 40 text-heavy PowerPoint slides. A talk is live performance theater designed to plant a single unforgettable thesis into the audience's minds. Delivering a great talk requires a relentless Through-Line, respecting strict word-count timing constraints (130 words per minute), scripting the visual interplay between speaker and screen, and practicing an opening hook that grabs attention within 30 seconds.1011---1213## 4-Step Conference Presentation & Keynote Pipeline1415### Step 1: The Through-Line (The Single Idea)161. **The One-Sentence Rule**:17 - Every talk must have exactly **one** through-line:18 - Example: *"Compilers are not mysterious black boxes; they are simple state machines that every engineer can inspect and optimize."*19 - If a slide or story does not directly advance the through-line, delete it without mercy.202. **The 3 Core Audience Questions**:21 - *Why this?* (Why does this topic matter right now?)22 - *Why you?* (What unique failure or data gives you authority to speak?)23 - *Why me?* (How does the attendee's daily work change tomorrow because of this talk?)2425### Step 2: Timing & Word Count Budgeting261. **The 130 Words-Per-Minute Constant**:27 - Conversational speaking pace on stage is strictly **120–140 words per minute**.28 - Standard Presentation Time Budgets:29 - *10-Minute Lightning Talk*: 1,200 words max.30 - *20-Minute Standard Tech Talk*: 2,500 words max.31 - *45-Minute Keynote*: 5,500 words max.32 - Going over your scheduled time is the ultimate cardinal sin of public speaking; it disrespects the organizers, the attendees, and the speakers following you.3334### Step 3: Slide Deck Choreography (One Idea Per Slide)351. **The Screen is Your Backdrop, Not Your Teleprompter**:36 - Slides should contain minimal text (target: $\le 6$ words per slide).37 - Use slides for visual punchlines, architecture diagrams, large readable code snippets (24pt font minimum), and high-contrast terminal captures.382. **The Speaker vs Screen Dance**:39 - Never turn around and read your slides with your back to the audience.4041### Step 4: The Scripting & Opening Hook Architecture421. **The First 30 Seconds**:43 - Never begin with throat-clearing: "Hi everyone, thank you for coming, can you hear me okay, my name is Dave and today I'm going to talk about..."44 - Start directly inside the action or the controversy:45 - *"At 2:14 AM on Christmas Eve, our production database dropped 40 million customer accounts. And I was the one who ran the script."*462. **The Call to Action (The Final Resonance)**:47 - End on a high, inspiring, actionable note that gives the audience a homework assignment for Monday morning.4849---5051## Deliverable Format: Keynote Script & Slide Plan (`KEYNOTE-SCRIPT.md`)5253```markdown54# Conference Talk Script & Slide Plan: [Talk Title]55*Event: [Conference Name] | Duration: 20 Minutes (Target: 2,500 words)*56*The Through-Line: [Single sentence thesis]*5758## 1. Slide & Script Choreography5960### [Slide 1: Plain Black Screen with Blood-Red Text: "02:14 AM"]61**Spoken Voiceover (Time: 0:00 - 0:45 | 100 words)**:62At 2:14 AM on Christmas Eve, my phone buzzed. Then it buzzed again. By 2:16, sixteen engineers were on a frantic Zoom bridge staring at an empty AWS RDS console. 40 million records gone. 63Most post-mortems blame human error. Today, I'm going to prove to you that human error is a myth—and that our database tooling was actively engineered to deceive us.6465---6667### [Slide 2: Architecture Diagram — The Illusion of High Availability]68**Spoken Voiceover (Time: 0:45 - 2:30 | 220 words)**:69Let's look at what we thought we built. On paper, it was textbook elegance: multi-region active-passive replication with automated failover... [Continue technical breakdown]7071---7273### [Slide 3: Big Code Snippet: 3 Lines of Rust]74**Spoken Voiceover (Time: 2:30 - 4:00 | 195 words)**:75Here is the bug. Notice line 42. It looks innocent, doesn't it? But under heavy concurrent load...7677## 2. Rehearsal Timing Verification78- [ ] Total word count: 2,420 words (Target: 2,500 words).79- [ ] Practice run 1: 18 minutes, 40 seconds.80- [ ] Code snippet slides tested for readability from 50 feet away (32pt font).81```8283---8485## Worked Example: 20-Minute Technical Keynote8687- **Topic**: "Debugging Production Distributed Traces".88- **Execution**: Scripted to exactly 2,450 words across 28 visual slides. Opened with a 15-second personal outage story.89- **Outcome**: Delivered in 19 minutes, 15 seconds; ranked #1 speaker out of 42 presenters at the annual developer conference.9091---9293## Verification Checklist9495- [ ] Talk possesses a single, clearly articulated through-line.96- [ ] Script adheres strictly to the 130 words-per-minute budget.97- [ ] Opening grabs attention within the first 30 seconds without biographical filler.98- [ ] Slide text is minimal (large diagrams/code; no bullet-point paragraphs).99- [ ] Total rehearsal time leaves at least 2 minutes of buffer under the session limit.100101---102103## Anti-Patterns104105- **Wall-of-Text Slides**: Putting 8 bullet points of 14pt text on a slide and reading them verbatim.106- **Overrunning Time**: Speaking for 28 minutes in a 20-minute slot until the organizers cut your microphone.107- **The Apologetic Intro**: Spending the first 2 minutes apologizing for being nervous or complaining about slide formatting.