decocms / pptx

pptx — PowerPoint presentations

Reading and inspection of .pptx files. Editing and creation are not yet
supported.

Making a presentation, slide deck, or "slides"? This is NOT the
skill — use the slides skill (/app/org/public/core/slides/SKILL.md),
which authors HTML decks with a live, editable preview. Reach for pptx
ONLY when the user explicitly works with a PowerPoint .pptx file —
reading one they uploaded, or when they specifically ask for .pptx
output (not yet supported here).

Quick reference

Every command writes its output next to the input file and prints the
output path(s) on stdout.

Reading text

pptx-extract prints each slide as a ## Slide N section followed by the
visible text. Speaker notes are excluded by default; pass --notes to
include them under a ### Notes subsection per slide.

Visual overview

pptx-thumbnail produces two artifacts:

• A composite grid image at <input-stem>.thumbnail.jpg — 4-column grid
  with a small slide-number overlay on each cell. Suitable for a single
  multimodal read to get the shape of the deck.

• A directory <input-stem>.slides/ containing per-slide JPGs at the
  same resolution. When a slide in the grid looks interesting, read
  slide-NNN.jpg directly instead of re-running pptx-thumbnail.

To actually see the rendered image, call the read tool on the path
pptx-thumbnail printed:

read /home/sandbox/deck.thumbnail.jpg

The image is injected into the next turn as a vision input.

Per-slide rasterization

pptx-rasterize renders specific slides at higher DPI (default 150) into
<input-stem>.rasterized/slide-NNN.jpg. Use --pages 3 for a single
slide or --pages 1,3-5 for a selection. Override DPI with --dpi.

Pass the resulting path to the read tool to actually see the slide.

Raw XML

pptx-unpack unzips the .pptx into <input-stem>.unpacked/. Useful
locations inside:

• ppt/slides/slideN.xml — slide content
• ppt/notesSlides/notesSlideN.xml — speaker notes
• ppt/media/ — embedded images
• ppt/theme/ — color palette and font definitions

Direct python-pptx usage

For programmatic access beyond what these scripts cover (table cell data,
shape positions, layout metadata, etc.), import pptx directly. The
library is preinstalled.

from pptx import Presentation
prs = Presentation("/path/to/file.pptx")
for slide in prs.slides:
    for shape in slide.shapes:
        ...