presentation-builder

SKILL.md

Presentation Builder

Use slides-grab when the user needs a real slide deck artifact, not just an outline. The workflow is HTML-first: plan the deck, generate slide HTML, review visually, then export to PPTX/PDF.

When to use this skill

Create a presentation from a topic, document, or brief

Iterate on slide design visually instead of editing raw PPT manually

Export approved decks to .pptx or .pdf

Maintain multi-deck workspaces under decks/<deck-name>/

Preflight

Install and verify slides-grab before authoring:
git clone https://github.com/vkehfdl1/slides-grab.git
cd slides-grab
npm ci
npx playwright install chromium
npm exec -- slides-grab --help

Minimum requirement: Node.js >= 18.

If slides-grab is already available in the current project, reuse the existing install instead of cloning again.

Workflow

1. Plan the deck

Collect:

presentation goal

audience

tone/style

target slide count

required source material

Create a concise outline, usually slide-outline.md, with:

slide number

slide title

key message

required visuals/data

Do not move to slide generation until the outline is approved.

2. Generate slide HTML

Use a dedicated workspace such as decks/<deck-name>/.

Create self-contained slide files:

decks/<deck-name>/
  slide-01-cover.html
  slide-02-problem.html
  slide-03-solution.html
  ...

Rules:

one primary idea per slide

keep HTML/CSS easy for agents to edit

inline only the assets/styles the deck actually needs

keep speaker notes or rationale outside slide body when possible

3. Build and review

After generating or editing slides:

slides-grab build-viewer --slides-dir decks/<deck-name>
slides-grab validate --slides-dir decks/<deck-name>

For visual iteration:

slides-grab edit --slides-dir decks/<deck-name>

Use the editor to select a region, request changes, and revise the corresponding HTML until the deck is approved.

4. Export artifacts

Only export after the design is approved.

slides-grab convert --slides-dir decks/<deck-name> --output decks/<deck-name>.pptx
slides-grab pdf --slides-dir decks/<deck-name> --output decks/<deck-name>.pdf

Report:

output file paths

validation status

any slides that still need manual polish

Core commands

slides-grab edit
slides-grab build-viewer
slides-grab validate
slides-grab convert
slides-grab pdf
slides-grab list-templates
slides-grab list-themes

All commands support --slides-dir <path>.

Guardrails

Follow the stage order: Plan -> Design -> Review -> Export

Do not export a deck the user has not approved

Fix source HTML/CSS when validation or conversion fails; do not patch exported binaries

Reuse the same deck directory through revisions to preserve stable iteration history

Example prompts

Create an 8-slide enterprise product deck in decks/acme-launch.
Audience: IT buyers.
Tone: confident, clean, technical.
Need PPTX and PDF exports after approval.

Turn this product brief into a 10-slide investor deck.
Use slides-grab, show me the outline first, then generate the deck in decks/series-a.

References

Source repo: https://github.com/vkehfdl1/slides-grab

Key workflow from upstream: plan -> design -> visual edit -> export