slides-grab-export

name	slides-grab-export
description	Stage 3 conversion skill for Codex. Convert approved HTML slides to PDF or per-slide PNG reliably, and to experimental / unstable PPTX/Figma outputs on a best-effort basis.
metadata	{"short-description":"Convert slides and run conversion checks"}

slides-grab Export Skill (Codex)

Use this only after the user approves design output.

Goal

Convert reviewed slide HTML into PDF or per-slide PNG reliably, and into experimental / unstable PPTX/Figma outputs on a best-effort basis.

Inputs

• Approved <slides-dir>/slide-*.html
• Optional output path settings

Outputs

• Presentation artifact (.pdf, .png per slide, or .pptx)

Workflow

1. Confirm user approval for conversion.
2. Pick the right primary target:
   • Card-news / Instagram-style decks → slides-grab png --slides-dir <path> --slide-mode card-news --resolution 2160p (see slides-grab-card-news).
   • Widescreen slide decks → slides-grab pdf --slides-dir <path> --output <name>.pdf.
3. When per-slide raster output is needed (card news, social posts, thumbnails):
   • slides-grab png --slides-dir <path> --output-dir <path>/out-png --resolution 2160p
   • Add --slide-mode card-news for 1:1 cards.
4. If the user also wants a PDF deck:
   • slides-grab pdf --slides-dir <path> --output <name>.pdf
   • Add --slide-mode card-news when the deck is square.
5. If the user wants PPTX (experimental / unstable):
   • slides-grab convert --slides-dir <path> --output <name>.pptx
6. If the user wants Figma-importable PPTX (experimental / unstable):
   • slides-grab figma --slides-dir <path> --output <name>-figma.pptx
7. Report success/failure with actionable errors.

Rules

• Do not modify slide content during conversion stage unless explicitly requested.
• If conversion fails, diagnose and fix root causes in source HTML/CSS.
• Always tell the user that PPTX and Figma export are experimental / unstable and may require manual cleanup.
• Use the packaged CLI and bundled references only; do not depend on unpublished agent-specific files.

Reference

For detailed conversion behavior and tools, use:

• references/export-rules.md
• references/pptx-skill-reference.md — archived full PPTX workflow guidance
• references/html2pptx.md — archived converter usage guide
• references/ooxml.md — archived OOXML reference