// Create effective presentations, slide decks, and workshop materials. Use when building MARP decks, PowerPoint content, demo scripts, or any audience-facing material.
| name | presentation-writing |
| description | Create effective presentations, slide decks, and workshop materials. Use when building MARP decks, PowerPoint content, demo scripts, or any audience-facing material. |
Slides are not documents. A slide that requires reading has failed.
Every slide has:
Bad: "Architecture Overview" Good: "Event-driven architecture reduces coupling between services by 60%"
The headline IS the takeaway. If someone only reads headlines, they get the full story.
Can the audience get the point in 3 seconds?
Rules:
| Talk type | Use | Why |
|---|---|---|
| Keynote / inspire | Duarte (story arc) | Tension between "what is" and "what could be" |
| Technical deep-dive | Minto (pyramid) | Lead with conclusion, support with evidence |
| Data/analytics | Tufte (data-dense) | Maximize information density, minimize chartjunk |
| Workshop / tutorial | Mayer (multimedia) | Reduce cognitive load, pair visuals with narration |
| Executive briefing | Minto + Duarte | Pyramid structure with emotional hook |
For markdown-based decks (MARP/Marpit):
---
marp: true
theme: default
paginate: true
---
# Assertion Headline
- Evidence point 1
- Evidence point 2
- Evidence point 3
---
Key MARP directives:
<!-- _class: lead --> — title slides<!-- _backgroundColor: #1a1a2e --> — dark slides — background image positioning<!-- footer: 'Company © 2026' --> — persistent footer