Name: pptx
Author: appautomaton

Presentation creation, editing, and analysis. When Claude needs to work with presentations (.pptx files) for: (1) Creating new presentations, (2) Modifying or editing content, (3) Working with layouts, (4) Adding comments or speaker notes, or any other presentation tasks

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: 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 1. Settle the design system ( design.md ): palette, type scale, grid. State it in two sentences before writing code. 2. Write one HTML file per slide, following the rules in html2pptx.md . Mark chart and table areas with class="placeholder" . 3. Write a build script that calls html2pptx() for each slide, adds charts and tables at the placeholders with PptxGenJS, and calls pptx.writeFile({ fileName }) . html2pptx throws every problem on a slide at once; fix them all and rerun. 4. Check the output (below). New deck from a template 1. 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. 2. Inventory its layouts. List every slide by 0 based index with its purpose, e.g. "12: two columns, heading + bullets each". 3. 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. 4. Assemble the slides. Duplicates are complete, with charts, embedded workbooks, notes and links: 5. Inventory the text. Read all of inventory.json : 6. Write the replacements (format below), then apply them: 7. 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 placeholders default font size , when the layout sets one overflow , overlap and warnings , 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: Paragraph fields: text , bold , italic , underline font size , font name color ( "C0392B" ) or theme color ( "ACCENT 1" ) alignment ( LEFT , CENTER , RIGHT , JUSTIFY ) space before , space after , line spacing (in points) bullet with level 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: Speaker notes 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. 1. 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.pptx so 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. 2. Look. Run uv run <skill /ooxml/scripts/render.py deck.pptx pages and 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 placeholders gives an overview, with every text box outlined. 3. 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.