// Generate PowerPoint (PPTX) presentations from a topic, outline, or content file. Creates professional slides using python-pptx with consistent theming and typography. Modes: [topic] (from scratch), from [file] (from markdown), --slides N, --theme dark|light|corporate, --outline-only, --out [path], --lang [code].
[HINT] 下载包含 SKILL.md 和所有相关文件的完整技能目录
| name | presentation |
| description | Generate PowerPoint (PPTX) presentations from a topic, outline, or content file. Creates professional slides using python-pptx with consistent theming and typography. Modes: [topic] (from scratch), from [file] (from markdown), --slides N, --theme dark|light|corporate, --outline-only, --out [path], --lang [code]. |
Generate professional PPTX presentations from a topic description, outline, or existing content file. Uses python-pptx to produce slides with consistent design, speaker notes, and visual variety.
Requires: python-pptx (pip install python-pptx)
Scope: Generating slide decks from topics or content files. Out of scope: Editing existing PPTX files, complex data visualizations (charts, graphs), image generation.
Read ../../shared/includes/run-logger.md for log format and file path resolution.
Read ../../shared/includes/retrospective.md for log format and file path resolution.
| Argument | Behavior |
|---|---|
[topic] | Plan outline from scratch, generate slides |
from [file] | Build slides from existing markdown or text file |
--slides N | Target slide count (default: 10) |
--theme dark|light|corporate | Color theme (default: corporate) |
--out [path] | Output path (default: ./[topic-slug].pptx) |
--outline-only | Generate outline for approval, do not create PPTX |
--lang [code] | Content language (default: same as topic input) |
Examples:
zuvo:presentation "Q1 2026 Product Review"
zuvo:presentation from docs/architecture.md --slides 8
zuvo:presentation "Security Audit Results" --outline-only
zuvo:presentation "Quarterly Report" --lang pl --theme dark
| Input | Action |
|---|---|
| Topic string | Plan outline from scratch (1.2) |
from [file] | Read file, extract sections as slide candidates (1.3) |
Generate a structured outline. Each slide needs:
Slide [N]: [Type]
Title: [slide title]
Content: [bullets or description]
Speaker notes: [optional context]
Slide types:
| Type | Use for |
|---|---|
| TITLE | Opening -- presentation title, subtitle, date |
| SECTION | Section divider -- large title, minimal content |
| CONTENT | Standard -- title + bullet points (max 6 bullets) |
| TWO_COLUMN | Comparison, before/after, pros/cons |
| QUOTE | Key insight, important statement |
| METRICS | Numbers, KPIs, statistics (2-4 big numbers) |
| TIMELINE | Process steps, roadmap, milestones (3-6 items) |
| IMAGE_PLACEHOLDER | Slide with image area + caption (user fills later) |
| SUMMARY | Key takeaways (3-5 points) |
| CLOSING | Thank you, Q&A, contact info |
Structure rules:
Read the source file. Map sections to slides:
| Markdown element | Slide type |
|---|---|
# Heading | TITLE or SECTION |
## Heading | CONTENT slide title |
| Bullet lists | Slide bullets (split if more than 6) |
| Tables | TWO_COLUMN or METRICS |
| Code blocks | CONTENT with monospace note |
| Blockquotes | QUOTE |
If the file has more than 15 sections and --slides is set, merge related sections to fit.
--outline-only: print outline and STOPProceed? (y / edit / n)| Theme | Background | Text | Accent | Accent 2 | Subtitle |
|---|---|---|---|---|---|
| light | #FFFFFF | #1A1A2E | #0066CC | #00A86B | #6B7280 |
| dark | #1A1A2E | #F0F0F0 | #4DA6FF | #66D9A5 | #9CA3AF |
| corporate | #FFFFFF | #2D3748 | #1A365D | #C05621 | #718096 |
Title slides: Calibri 36pt Bold
Section slides: Calibri 32pt Bold
Slide titles: Calibri 28pt Bold
Body text: Calibri 18pt
Bullets: Calibri 16pt
Speaker notes: Calibri 12pt
Metrics: Calibri 48pt Bold
Quotes: Calibri 24pt Italic
Captions: Calibri 11pt (subtitle color)
Slide: 13.333 x 7.5
Margins: left 0.8, right 0.8, top 1.2 (below title), bottom 0.6
Title Y: 0.4, height 0.8
Content Y: 1.4, width 11.733, height 5.5
Column gap: 0.4 (TWO_COLUMN)
Footer Y: 7.0
Generate scripts/generate_presentation.py with the planned outline and theme embedded. The script uses python-pptx to build each slide programmatically.
Script includes:
set_slide_bg, add_textbox, add_bullets, add_accent_barEach builder function receives the specific content for that slide (title, bullets, metrics values, etc.) and applies the theme consistently.
python3 scripts/generate_presentation.py
Verify:
ls -la [output_path]
python3 -c "from pptx import Presentation; p = Presentation('[output_path]'); print(f'Slides: {len(p.slides)}')"
If user interaction is available, ask whether to keep the script. If not available, keep it (useful for re-generation and manual editing).
PRESENTATION CREATED
-----
File: [output_path]
Slides: [N]
Theme: [theme name]
Size: [file size]
Slide overview:
1. [TITLE] -- [title text]
2. [CONTENT] -- [title text]
3. [METRICS] -- [title text]
...
Script: scripts/generate_presentation.py
Run: <ISO-8601-Z> presentation <project> - - <VERDICT> - <DURATION> <NOTES> <BRANCH> <SHA7> <INCLUDES> <TIER>
-----
Follow the retrospective protocol from retrospective.md.
Gate check → structured questions → TSV emit → markdown append.
If gate check skips: print "RETRO: skipped (trivial session)" and proceed.
After printing this block, append the Run: line value (without the Run: prefix) to the log file path resolved per run-logger.md.
<DURATION>: use N-slides (number of slides generated).
To modify:
Edit scripts/generate_presentation.py and re-run
Add images: open in PowerPoint, replace IMAGE_PLACEHOLDER slides
Change theme: edit THEME dict in script, re-run
| Error | Action |
|---|---|
| python-pptx not installed | Print pip install python-pptx and stop |
| Output path not writable | Fall back to ./presentation.pptx |
| Script execution fails | Show error, keep script for debugging |
from [file] -- file not found | Print error, ask for correct path |