/speech — Speech Draft Generator (PRD §17.6)
When to invoke
/speech <topic>— default 5 minutes, formal tone/speech <topic> --duration 10m --tone persuasive/speech <topic> --tone casual— wedding toast, light keynote
Word-count calibration
| Duration | Words target | Use for |
|---|---|---|
| 1m | ~150 | Lightning intro |
| 5m | ~750 | Standard talk |
| 10m | ~1500 | Conference talk |
| 15m | ~2250 | Keynote |
| 20m+ | ~3000+ | Long-form lecture |
Tone rubric
- formal: precise vocabulary, full sentences, no contractions, citations OK
- casual: contractions, anecdotes, shorter sentences, occasional rhetorical questions
- persuasive: tricolons, repetition, call-to-action close, emotional hooks
Structure (apply regardless of tone)
- Hook (10-15% of words): question, statistic, story, or paradox
- Roadmap (5-10%): "Today we'll cover three things..."
- Main points (60-65%): 3 sections with transitions
- Story / evidence (10-15%): one anchor anecdote
- Close (5-10%): callback to hook + CTA
How it works
This skill is module-free — it's pure agent prompting. The agent:
Recalls mnemon facts on
<topic>for source material.Builds outline matching the structure above.
Drafts speech to target word count (compute words = duration × 150).
Counts words, trims/expands to land within ±5% of target.
Writes Markdown to
${VAULT_PATH}/speeches/YYYY-MM-DD_<topic>.mdwith frontmatter:--- title: <topic> duration: <Xm> tone: <formal|casual|persuasive> word_count: <actual> target_words: <target> created: <ISO date> ---Reply with file path + first paragraph preview.
Must-do
- Hit the target word count within ±5%.
- Include a delivery tip in frontmatter (
pace_wpm: 150,pause_after_hook: true). - Save to
vault/speeches/, Markdown format.
Must-not-do
- Don't add disclaimers like "this is AI-generated" inside the speech body.
- Don't include speaker stage directions in the body — those go in frontmatter.