| name | skill-deck |
| description | Generate slide deck presentations from briefs — use when you need slides, pitch decks, or visual summaries |
Host: Codex CLI — This skill was designed for Claude Code and adapted for Codex.
Cross-reference commands use installed skill names in Codex rather than /octo:* slash commands.
Use the active Codex shell and subagent tools. Do not claim a provider, model, or host subagent is available until the current session exposes it.
For host tool equivalents, see skills/blocks/codex-host-adapter.md.
Slide Deck Generator
Generate professional slide decks from briefs with optional research, outline approval, and PPTX export.
Prerequisites
The document-skills plugin MUST be installed for PPTX rendering:
/plugin list | grep document-skills
If not installed, tell the user:
The document-skills plugin is required for PPTX generation.
Install it with: /plugin install document-skills@anthropic-agent-skills
Pipeline (4 Steps)
Step 1: Gather Brief
Parse the user's topic and description. Use AskUserQuestion to clarify:
Question 1 - Audience:
- Executives / Board
- Engineers / Technical
- Investors / Fundraising
- General / Mixed
Question 2 - Slide count target:
- Short (5-10 slides)
- Standard (10-20 slides)
- Extended (20+ slides)
Question 3 - Tone:
- Formal / Business
- Technical / Detailed
- Casual / Conversational
If the user already provided clear context (e.g., "10-slide investor pitch deck about our Series A"), skip questions where the answer is obvious.
Step 2: Research (Optional)
If the topic needs external research or context gathering:
- Use the host subagent tool with
Explore or general-purpose subagent to gather relevant information
- For deeper multi-AI research, suggest: "For comprehensive multi-provider research, run
/octo:discover [topic] first, then /octo:deck to build slides from the results"
- If the user provides their own content, notes, or a research file, skip this step entirely
This step is OPTIONAL. Many decks are built from the user's own knowledge or existing documents.
Step 3: Generate Outline
Build a slide-by-slide outline in markdown format. Structure:
## Slide 1: [Title Slide]
- Presentation title
- Subtitle / Date / Author
## Slide 2: [Agenda / Overview]
- Key topics to cover
## Slide 3: [First Content Section]
- Bullet point 1
- Bullet point 2
- Bullet point 3
## Slide N: [Summary / Next Steps]
- Key takeaways
- Call to action
IMPORTANT: Present the outline to the user for approval using AskUserQuestion:
- "Looks good, generate PPTX" — Proceed to Step 4
- "Add more slides" — Expand specific sections
- "Change focus" — Restructure around different themes
- "Start over" — Return to Step 1
This is the wireframe gate — the user MUST approve the outline structure before PPTX generation.
Step 4: Render PPTX
Once the outline is approved:
- Use the
document-skills:pptx skill to convert the approved markdown outline to PowerPoint
- Each
## heading becomes a slide
- Bullet points under each heading become slide content
- Save the PPTX file to the current working directory with a descriptive filename
Example filename: Series-A-Pitch-Deck-2026-02-14.pptx
Slide Structure Best Practices
Apply these when generating outlines:
- Title slide: Presentation name, subtitle, date, presenter
- Agenda slide: 3-5 key topics (for decks > 7 slides)
- One idea per slide: Keep slides focused
- 5-7 bullets max: Per slide for readability
- Summary slide: Key takeaways at the end
- Next steps / CTA: Final slide with clear actions
By Audience Type
Executives / Board:
- Lead with business impact and metrics
- Use "So what?" framing for every slide
- Include financial implications
- End with decisions needed
Engineers / Technical:
- Include architecture diagrams (describe for slides)
- Show trade-offs and alternatives considered
- Include implementation timelines
- Reference technical specifications
Investors / Fundraising:
- Problem → Solution → Market → Traction → Team → Ask
- Include market size (TAM/SAM/SOM)
- Show growth metrics and projections
- Clear funding ask and use of funds
General / Mixed:
- Balance detail with accessibility
- Define technical terms
- Use analogies and examples
- Include visual descriptions
Integration with Other Skills
This skill works well in combination with:
/octo:discover [topic] — Research first, then build deck from findings/octo:docs — For converting existing markdown to other formats/octo:prd — Generate a PRD, then create a presentation summarizing it/octo:brainstorm — Brainstorm ideas, then structure into a deck
Example Workflows
Quick Deck from Brief
User: "Create a 10-slide deck about our Q1 results"
→ Step 1: Clarify audience (executives)
→ Step 2: Skip (user has the data)
→ Step 3: Generate outline, get approval
→ Step 4: Render PPTX
Research-Backed Deck
User: "Build a presentation about AI trends in healthcare"
→ Step 1: Clarify audience and scope
→ Step 2: Research using Task agents
→ Step 3: Generate outline from research, get approval
→ Step 4: Render PPTX
Deep Research + Deck
User: "I need a comprehensive investor deck about the autonomous vehicles market"
→ Suggest: "/octo:discover autonomous vehicles market" first
→ Then: "/octo:deck" using the research synthesis
Slide deck skill for claude-octopus v8.12.0+
