slides-grab Skill - Mode Router
Decides how the deck should be built and routes to the right pipeline. Read the user's intent, pick a delivery mode, then hand off to the matching sub-skill for the detailed stage instructions. Both pipelines share the same Stage 1 (slides-grab-plan) and Stage 3 (slides-grab-export) skills; the difference is how Stage 2 produces slides.
Pick a delivery mode
Ask the user (or infer from the request) which pipeline to use:
| Signal | Route to |
|---|---|
| "make slides about X", "write a deck", editable text, searchable content, accessibility, charts, diagrams, Card-news, most greenfield decks | slides-grab-html — semantic HTML slides |
| "make slides in this template/form", "match this existing deck", visual fidelity to a corporate template matters more than editable text, user handed a filled PPTX/PDF and wants the same look | slides-grab-image — image-native raster wrapper slides |
When in doubt, default to slides-grab-html. Only choose image-native when the user explicitly prioritizes visual matching to an existing template over editability.
After picking the mode, read the matching sub-skill in full and follow its pipeline. Do not mix instructions from the two sub-skills — the image generation steps are different and must not be combined.
Shared stages (both pipelines)
Stage 1 — Plan
Use the installed slides-grab-plan skill. The plan stage records the chosen mode: html or mode: image-native in slide-outline.md meta so Stage 2 knows which pipeline to run. Do not proceed to Stage 2 without approval of both style and outline.
Stage 3 — Export
Use the installed slides-grab-export skill. Export is gated on a Stage 2 design-gate Proceed verdict. PPTX and Figma are experimental / unstable.
- Confirm user wants conversion.
- Pick the primary target:
- Card-news / Instagram-style decks →
slides-grab png --slides-dir <path> --slide-mode card-news --resolution 2160p(seeslides-grab-card-news). - Widescreen decks →
slides-grab pdf --slides-dir <path> --output <name>.pdf.
- Card-news / Instagram-style decks →
- Per-slide PNG (any mode):
slides-grab png --slides-dir <path> --output-dir <path>/out-png --resolution 2160p. - PPTX (optional, experimental / unstable): use
slides-grab convert --slides-dir <path> --output <name>.pptx --engine rasterfor visual fidelity (default), or--engine textfor best-effort editable text. - Figma-importable PPTX (optional, experimental / unstable):
slides-grab figma --slides-dir <path> --output <name>-figma.pptx. - Report results.
Shared rules (apply to both pipelines)
- Always follow the stage order: Plan → Design → Export.
- Get explicit user approval before advancing to the next stage.
- Pass the design gate before export: Stage 2 must end with a
Proceedverdict (zero unresolved Critical findings) on the latest rendered state.slides-grab pdf,slides-grab convert, andslides-grab figmablock if the receipt is missing, stale, or fails the CLI-enforced report contract. - Use
decks/<deck-name>/as the slides workspace for multi-deck projects. - Call out export risk clearly: PPTX and Figma export are experimental / unstable.
- For complex diagrams, default to a
tldraw-generated asset unless the user explicitly asks for a different approach. - When a slide needs bespoke imagery inside an HTML deck, prefer the default codex-imagen provider via
slides-grab image(reuses local Codex ChatGPT login — no API key required; runcodex loginonce) and keep the saved asset local under<slides-dir>/assets/. Image-native decks generate each whole-slide raster withslides-grab image --image-native --name slide-XXso the wrapper and editor metadata are created together — see the image sub-skill. - When a slide needs a chart, default to Chart.js in-slide canvas rendering and require
slides-grab validateplusslides-grab build-viewerreview so blank canvases are caught asempty-canvasbefore export. Local videos live under<slides-dir>/assets/withposter="./assets/<file>"thumbnails; useslides-grab fetch-videooryt-dlpto pull supported web videos first. - Use
slides-grab list-stylesandslides-grab preview-stylesfor bundled style discovery during planning.
Reference
references/presentation-workflow-reference.md— archived end-to-end workflow guidance from the legacy skill set../slides-grab-html/SKILL.md— HTML-mode pipeline (semantic slides)../slides-grab-image/SKILL.md— image-native pipeline (raster wrapper slides)

