Talk stage 5: Script

Produces the complete talk in 3 deliverables: the 5-act narrative with speaker notes, the slide specification, and the Kimi prompt ready to copy-paste.

Prerequisite: The user has validated angle + title at the Stage 4 CHECKPOINT. Do not run this stage without that confirmation.

When to use this skill

• After Stage 4 CHECKPOINT is confirmed
• When you have a validated angle + title
• To produce the complete script and slide spec

What this skill does

1. Verifies inputs: all upstream files + angle/title confirmation
2. Loads the Kimi template: from templates/kimi-prompt-template.md
3. Builds the pitch: 5-act structure with speaker notes and timing
4. Builds the slide spec: slide by slide with visual, text, notes
5. Generates the Kimi prompt: fills the template with talk content
6. Saves 3 files

Input

• talks/{YYYY}-{slug}-summary.md
• talks/{YYYY}-{slug}-concepts.md
• talks/{YYYY}-{slug}-angles.md
• talks/{YYYY}-{slug}-titre.md
• talks/{YYYY}-{slug}-timeline.md (optional, enriches speaker notes)
• Chosen angle + chosen title (explicit user confirmation from Stage 4)

Output

• talks/{YYYY}-{slug}-pitch.md
• talks/{YYYY}-{slug}-slides.md
• talks/{YYYY}-{slug}-kimi-prompt.md

pitch.md Format

# Pitch: {title}

**Event**: {event} | **Duration**: {duration} min | **Slides**: ~{n} slides
**Angle**: {selected angle}

---

## Global structure

| Act | Title | Duration | Slides |
|-----|-------|----------|--------|
| 1 | {act title} | {n} min | {n} slides |
...
| Total | | {duration} min | {n} slides |

---

## ACT 1: {TITLE} (Slides 1-{n}, ~{n} min)

{Narrative description of the act in 2-3 sentences: what happens, the emotion targeted}

---

**Slide {n}: {Slide title}**
- Visual: {visual description, simple and precise}
- Key text: {what appears on screen, max 10 words}
- Speaker notes: "{exact text to say, conversational and natural}"
- Duration: {n} min
- Pause: yes/no | {if yes: why, intended effect}

---

[Repeat for each slide in the act]

---

[Acts 2, 3, 4, 5: same structure]

---

## Key moments (must not be rushed)

| Moment | Slide | What happens | Technique |
|--------|-------|-------------|-----------|
| {moment} | {n} | {description} | Pause / Number / Anecdote |

---

## Timing check

| Act | Planned | Buffer | Total |
|-----|---------|--------|-------|
| ACT 1 | {n} min | 30s | {n} min |
...
| **Total** | **{n} min** | **{n} min** | **{n} min** |

Q&A planned: {n} min

slides.md Format

Slide-by-slide spec, ready to hand to a designer or pass to Kimi.

# Slides Spec: {title}

**Total**: {n} slides | **Event**: {event} | **Date**: {date}

---

### SLIDE 1: Title Slide

- **Main title**: {title}
- **Subtitle**: {subtitle or tagline}
- **Speaker**: {name}
- **Event**: {event} ({date})
- **Visual**: {background description, texture, image, mood}
- **Speaker notes**: "{text}"
- **Duration**: {n} sec

---

### SLIDE {n}: {Slide title}

- **Title**: {title}
- **Visual**: {precise visual description}
  - Type: {bar chart / timeline / diagram / big number / comparison table / screenshot placeholder}
  - Data: {specific values if chart}
- **Key text**: {what appears, max 30 words total}
- **Metrics displayed**: {numbers if metrics slide}
- **Speaker notes**: "{exact text}"
- **Duration**: {n} min
- **Act**: {act number}

---

[Repeat for each slide]

---

## Screenshots to capture

| Slide | Screenshot | Source | Status |
|-------|-----------|--------|--------|
| {n} | {description} | {tool/URL} | To capture / Available |

kimi-prompt.md

Fill the template at templates/kimi-prompt-template.md with the talk's content.

Required sections to complete:

• Full title and subtitle
• Speaker name + event + date + duration + language + slide count
• Design requirements (adjust color palette if different from default)
• Slide Content Structure (section by section, all 5 acts)
• Screenshot placeholders (slides awaiting real captures)
• Tone reference (adapt to the talk's style)

Verify no {PLACEHOLDER} remains in the final file before handing to the user.

Script construction rules

• 1 idea per slide: never more, never less
• Speaker notes = what you say, not what you read: minimal slides, conversational notes
• Numbers are heroes: metrics appear large and alone on their slide
• Anecdotes > explanations: "one Tuesday morning, 3 bugs..." > "git worktrees enable parallelism"
• Explicit transitions: note the link between each act in the notes
• Realistic timing: add 10% buffer total (slides always run long)

Anti-patterns

• Slides loaded with bullets (never more than 5 words per line)
• Speaker notes in technical jargon (read them aloud to validate)
• Vague Kimi prompt ("make it look nice"): each slide must be precise
• Omitting screenshot placeholders from the Kimi prompt
• Generating more slides than the duration allows (2-3 min/slide for REX)

Validation checklist

• Pitch covers 5 acts with coherent timing (within 10% of target duration)
• Each slide has visual + text + speaker notes
• Key moments identified (pauses, punchlines, transitions)
• Slides spec ready to hand to a designer
• Kimi prompt complete (all template sections filled)
• Screenshots to capture listed with source
• No {PLACEHOLDER} remaining in kimi-prompt.md
• 3 files saved

Using the Kimi prompt

1. Open {slug}-kimi-prompt.md
2. Verify no {PLACEHOLDER} remains (search the file)
3. Go to kimi.com (free account, no API needed)
4. Start a new conversation
5. Copy-paste the entire prompt
6. Kimi generates the presentation

For iterative refinement: add follow-up messages targeting specific slides. "Slide 7: make the number larger, remove the bullet list."

Tips

• Speaker notes are the heart of this stage; they're what distinguishes a good talk from a good slide deck
• The Kimi template includes a dark design system with orange accent colors. Adapt Color Palette in the template if your brand has different colors
• Generate more slides than needed in the first pass, then cut (easier than writing from scratch)

Templates

• Kimi prompt: templates/kimi-prompt-template.md

Related

• Stage 4: Position: prerequisite (CHECKPOINT required)
• Stage 6: Revision: reads pitch + slides
• Orchestrator