| name | create-pptx |
| title | Create Presentation |
| description | Generate a PowerPoint (.pptx) slide deck — pitch decks, reviews, summaries. Use when the user wants slides. Built with pptxgenjs (Node) for native, editable slides and charts. |
| target | docgen_agent |
Create Presentation
When to use
The deliverable is a .pptx slide deck.
How it works
A deck template here is a Node program (using pptxgenjs) that writes the .pptx. You adapt the slides' content, then the build script runs it and validates the output.
Rendering rules (do NOT break these)
The deck must look right in EVERY viewer, including macOS Keynote / Quick Look — not just PowerPoint:
- Never use
addChart. Native OOXML charts render blank in Apple viewers (only the title shows). Draw charts from shapes instead — rect bars, line + small ellipse markers for trends, colored rect segments for a stacked/share bar. The templates show how.
- Use a cross-platform font (
"Arial"). Fonts like "Segoe UI" trigger a "missing fonts" warning on macOS.
- No empty slides — every slide must have visible body content.
Skill directory: /workspace/integrations/docgen/agent/skills/create-pptx — templates/, reference.md, and scripts/ live here; read them by absolute path. Your work goes in ./scratch/.
Workflow (every job)
- Work in a job dir:
mkdir -p ./scratch/pptx-<short-name>.
- Adapt the closest template — don't start blank.
read /workspace/integrations/docgen/agent/skills/create-pptx/templates/deck.mjs (business review) or pitch-deck.mjs (startup pitch), then write the edited deck to ./scratch/pptx-<name>/deck.mjs. Read /workspace/integrations/docgen/agent/skills/create-pptx/reference.md for the slide-building blocks.
- Build + validate:
bash /workspace/integrations/docgen/agent/skills/create-pptx/scripts/build.sh ./scratch/pptx-<name>/deck.mjs ./scratch/pptx-<name>/out.pptx
Prints OK: <path> (slides=N) or ERROR: ....
- Fix loop: on
ERROR, read the message, fix, re-run. Cap at 5 attempts.
- Deliver:
mv ./scratch/pptx-<name>/out.pptx ./artifacts/<final-name>.pptx, then report the full path. Moving it into artifacts/ surfaces it to the user.
Layout discipline (important)
There is no automatic visual check — you place elements by coordinates (inches). To avoid overflow:
- Keep to ~6 bullets per slide, ~6–8 words per bullet.
- Use the template's
x/y/w/h grid; don't push text past the slide width (13.33in wide on the default widescreen layout).
- One idea per slide. Split dense content across slides.
Toolchain note
The build script installs pptxgenjs on first use; the first deck may take a little longer, then it's fast.
Never
- Never overload a slide — split it. Never leave the file in
./scratch/. Never skip build/validate.
Templates
Comprehensive starting points (all charts drawn with shapes, Arial font, ~12 slides) — adapt the closest fit:
deck.mjs — quarterly business review: title, agenda, section divider, bullets, 2-column comparison, KPI cards, a drawn bar chart, a drawn line + stacked-share slide, a table, a process/timeline, a quote, and a closing slide.pitch-deck.mjs — startup pitch deck: cover, problem, solution, product cards, market size (drawn), business model, traction (drawn chart + KPIs), competition matrix, go-to-market, team cards, the ask (drawn use-of-funds bar), closing.
