Menu
Create effective presentations, slide decks, and workshop materials. Use when building MARP decks, PowerPoint content, demo scripts, or any audience-facing material.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Write Architecture Decision Records when making significant technical choices. Use when selecting tools, patterns, frameworks, or making structural changes that future developers need to understand.
Write AGENTS.md files that serve as operating contracts for AI agents. Use when creating or updating AGENTS.md for a project. Trigger terms: AGENTS.md, agent instructions, agent contract, agent configuration, coding agent setup.
Quality rules for changelog entries. Use when validating, writing, or reviewing changelog content to ensure user-facing value communication.
Task completion sequence including verification, git, signaling, and handoff. Use when finishing a task or reporting status.
Architecture diagrams for documentation. Covers ASCII, Mermaid, C4, and D2. Applies C4 methodology by default. Trigger terms: diagram, flowchart, architecture diagram, sequence diagram, C4, mermaid, ascii diagram.
Classify documentation by audience and content type. Use when planning, auditing, or placing project documentation.
| 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