do-presentationlisted
Install: claude install-skill tomcounsell/ai
# Make a Presentation
Creates polished, educational presentations about any feature, concept, or system in the current repo. Outputs Marp markdown with PDF and HTML exports, styled to match the repo's design system.
## What this skill does
1. Researches the topic deeply across the codebase
2. Structures content using proven educational frameworks (high-school accessible)
3. Detects the repo's design system and builds a matching Marp theme
4. Generates diagrams (Mermaid/ASCII) for architecture and flows
5. Exports to PDF, HTML, and optionally PPTX
## When to load sub-files
| Sub-file | Load when... |
|----------|-------------|
| `CONTENT_GUIDE.md` | Structuring slide content — educational best practices, slide types, pacing |
| `THEME_DETECTION.md` | Building the Marp CSS theme — how to find and adapt the repo's design system |
## Quick start
The topic comes from `$ARGUMENTS`. If empty, ask the user what to present on.
### Step 1: Scope the topic
Determine what the presentation covers:
- A single feature? A system overview? A concept explanation?
- Who is the audience? Default: **general technical audience, high-school reading level**
- How long? Default: **10-15 slides** (5-8 minute talk)
Ask the user only if the scope is genuinely ambiguous. Otherwise, make a reasonable call.
### Step 2: Research
Spawn an Explore agent to deeply research the topic:
- Read relevant source files, docs, READMEs, and config
- Trace how the feature works end-to-end
- Identify the 3-5