pptx
Create, edit, and analyze PowerPoint decks (.pptx). Build new decks from HTML slides, fill an existing template, duplicate or reorder slides, edit slide XML, and read or write speaker notes. Use when a task produces or modifies a .pptx file, or needs text, layout, or notes read from one.
How do I install this agent skill?
npx skills add https://github.com/appautomaton/document-skills --skill pptxIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill is a comprehensive toolkit for PowerPoint (.pptx) file creation, editing, and analysis. It uses a combination of Python and Node.js to provide text extraction, slide reordering, thumbnail generation, and HTML-to-PPTX conversion. The skill follows security best practices, such as using secure XML parsing libraries to prevent entity injection attacks.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
1/56 files flagged
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
PowerPoint decks
You already know python-pptx and PptxGenJS. This skill adds a converter that turns HTML slides into native, editable PowerPoint objects, scripts that make template work reliable, and checks that show whether a deck is valid and looks right.
Running scripts
<skill> is the directory containing this file. Run bundled scripts by absolute path from the user's working directory, so relative paths to their files keep working:
uv run <skill>/scripts/thumbnail.py deck.pptx
Run Python you write with its dependencies declared, either uv run --with python-pptx script.py or a PEP 723 header. Run Node scripts as NODE_PATH=<skill>/node_modules node build.js; if <skill>/node_modules is missing, run npm install in <skill> once. Rendering needs LibreOffice (soffice) and poppler (pdftoppm).
Choosing a workflow
| Task | Workflow |
|---|---|
| Read a deck's text | uv run --with 'markitdown[pptx]' python -m markitdown deck.pptx |
| New deck, no template | html2pptx, below. Read html2pptx.md and design.md first. |
| New deck from a template | Template workflow, below |
| Change an existing deck | python-pptx for text and shapes. Slide XML (ooxml.md) for what python-pptx can't reach. |
| Speaker notes | scripts/notes.py |
markitdown labels slides from 1 (<!-- Slide number: 1 -->); every script here counts from 0. To take on an existing deck's look, read ppt/theme/theme1.xml from the unpacked file (<a:clrScheme>, <a:fontScheme>) and look at its thumbnail grid.
New deck: html2pptx
- Settle the design system (
design.md): palette, type scale, grid. State it in two sentences before writing code. - Write one HTML file per slide, following the rules in
html2pptx.md. Mark chart and table areas withclass="placeholder". - Write a build script that calls
html2pptx()for each slide, adds charts and tables at the placeholders with PptxGenJS, and callspptx.writeFile({ fileName }). html2pptx throws every problem on a slide at once; fix them all and rerun. - Check the output (below).
New deck from a template
-
See the template. Extract its text with markitdown, and make a thumbnail grid with
uv run <skill>/scripts/thumbnail.py template.pptx grid. Look at the grid images. -
Inventory its layouts. List every slide by 0-based index with its purpose, e.g. "12: two columns, heading + bullets each".
-
Map content to layouts. Count the pieces of content for each slide first, then pick a layout with exactly that many slots:
- two items to a two-column layout, three to three columns
- image layouts only when there are images
- quote layouts only for real quotes with attribution
- four or more items split across slides or into a list
Never leave a placeholder empty or invent filler to occupy one.
-
Assemble the slides. Duplicates are complete, with charts, embedded workbooks, notes and links:
uv run <skill>/scripts/rearrange.py template.pptx working.pptx 0,12,12,31,40 -
Inventory the text. Read all of
inventory.json:uv run <skill>/scripts/inventory.py working.pptx inventory.json -
Write the replacements (format below), then apply them:
uv run <skill>/scripts/replace.py working.pptx replacements.json output.pptx -
Check the output (below).
Inventory and replacements
inventory.json maps slide-N to shape-N, both 0-based. Shapes are ordered top to bottom, then left to right, and slide numbers are left out. Each shape has left, top, width and height in inches, and paragraphs. It also carries:
placeholder_type(TITLE,CENTER_TITLE,SUBTITLE,BODY,OBJECT, …), only for placeholdersdefault_font_size, when the layout sets oneoverflow,overlapandwarnings, when it detects them
Paragraphs list only the properties that differ from the default.
The replacements file has the same shape, with paragraphs for each shape to fill:
{
"slide-0": {
"shape-0": {"paragraphs": [{"text": "Revenue grew 18%", "bold": true}]},
"shape-1": {"paragraphs": [
{"text": "Renewals drove two thirds of growth"},
{"text": "Churn fell to 4%", "bullet": true, "level": 0}
]}
}
}
- Paragraph fields:
text,bold,italic,underlinefont_size,font_namecolor("C0392B") ortheme_color("ACCENT_1")alignment(LEFT,CENTER,RIGHT,JUSTIFY)space_before,space_after,line_spacing(in points)bulletwithlevel
- Carry over the properties the inventory shows for the slot, so the template's styling holds.
- Never type bullet characters. Bulleted paragraphs are left-aligned automatically.
- On each slide listed, every text shape is cleared and then filled. A shape left out of the file ends up empty, which removes leftover template text. Slides not listed are untouched.
- replace.py saves nothing if a key doesn't exist ("Shape 'shape-9' not found on 'slide-0'. Available shapes: …") or if new text overflows its box more than the old text did ("Text overflow worsened: slide-0/shape-2: …"). Shorten the text or choose a roomier layout.
Editing slide XML
Read ooxml.md first. Then unpack, edit, validate after each change, and pack:
uv run <skill>/ooxml/scripts/unpack.py deck.pptx unpacked
uv run <skill>/ooxml/scripts/validate.py unpacked --original deck.pptx
uv run <skill>/ooxml/scripts/pack.py unpacked edited.pptx
Speaker notes
uv run <skill>/scripts/notes.py deck.pptx # print {"slide-0": "…", …}
uv run <skill>/scripts/notes.py deck.pptx notes.json -o out.pptx
The JSON maps slide keys to plain text, with one paragraph per line. An empty string clears a slide's notes, and slides not listed keep theirs. In an html2pptx build, use slide.addNotes('…') instead.
Checking the output
A deck is done when it validates and every slide has been looked at.
-
Validate. For a new deck, run
uv run <skill>/ooxml/scripts/validate.py deck.pptx. For an edited deck or one built from a template, add--original template.pptxso only new problems are reported. Fix everything it lists.On duplicated slides, validate.py also reports schema errors the template already had. Compare them with the source slide before chasing them.
-
Look. Run
uv run <skill>/ooxml/scripts/render.py deck.pptx pagesand read every image. Look for:- text cut off, overlapping, or crowding an edge
- weak contrast
- leftover template text or empty placeholders
- anything off the grid
thumbnail.py deck.pptx grid --outline-placeholdersgives an overview, with every text box outlined. -
Fix and repeat until both are clean.
Pitfalls that fail silently
- PptxGenJS colours take no
#.'#C0392B'corrupts the file. - Text that fits in the browser overflows in PowerPoint when a font is substituted. Keep to the font policy in
design.md. - Duplicating a slide by copying its XML by hand loses charts and shares notes between slides. Use
rearrange.py. - Slide indices are 0-based everywhere except in markitdown's output.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/appautomaton/document-skills/pptx">View pptx on skillZs</a>