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.
1---2name: create-pptx3description: 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.4---56# Create Presentation78## When to use9The deliverable is a `.pptx` slide deck.1011## How it works12A 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.1314## Rendering rules (do NOT break these)15The deck must look right in EVERY viewer, including macOS Keynote / Quick Look — not just PowerPoint:16- **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.17- **Use a cross-platform font (`"Arial"`).** Fonts like "Segoe UI" trigger a "missing fonts" warning on macOS.18- **No empty slides** — every slide must have visible body content.1920**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/`.2122## Workflow (every job)231. **Work in a job dir:** `mkdir -p ./scratch/pptx-<short-name>`.242. **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.253. **Build + validate:**26 ```27 bash /workspace/integrations/docgen/agent/skills/create-pptx/scripts/build.sh ./scratch/pptx-<name>/deck.mjs ./scratch/pptx-<name>/out.pptx28 ```29 Prints `OK: <path> (slides=N)` or `ERROR: ...`.304. **Fix loop:** on `ERROR`, read the message, fix, re-run. Cap at 5 attempts.315. **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.3233## Layout discipline (important)34There is no automatic visual check — you place elements by coordinates (inches). To avoid overflow:35- Keep to ~6 bullets per slide, ~6–8 words per bullet.36- 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).37- One idea per slide. Split dense content across slides.3839## Toolchain note40The build script installs `pptxgenjs` on first use; the first deck may take a little longer, then it's fast.4142## Never43- Never overload a slide — split it. Never leave the file in `./scratch/`. Never skip build/validate.4445## Templates46Comprehensive starting points (all charts drawn with shapes, Arial font, ~12 slides) — adapt the closest fit:47- `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.48- `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.
theexperiencecompany