Presentations
Read ${SKILL_DIR}/../_shared/artifacts.md. Use python-pptx for portable PPTX
authoring. It is a different engine from OpenAI's private artifact-tool runtime;
do not execute that runtime's examples as if the APIs were interchangeable.
- Define the audience, decision, story, slide count, and source material. Write an outline with one main claim per slide, supported by actual evidence.
- Inspect any existing deck's slide size, masters, layouts, fonts, objects, notes, charts, and embedded resources. Work on a copy. Retain native editable text, shapes, tables, and charts rather than rasterizing entire slides.
- Build a consistent grid, title hierarchy, restrained palette, and readable type scale. Keep all objects within the slide. Prefer charts and diagrams when they explain a comparison or relationship; label axes and cite data.
- For edits, change the requested objects while preserving unrelated content.
Inspect effective typography at both paragraph-default and run levels;
a run's unset font properties can inherit the reference's font, size, and
color from its paragraph or theme. Prefer replacing text within existing
runs. Assigning
shape.textor clearing a text frame can discard paragraph defaults and silently flatten the hierarchy. If rebuilding is necessary, retain and restore paragraph properties (a:pPr) and run properties (a:rPr), including alignment, spacing, bullets, and color, then compare effective fonts against the reference after saving. Do not treat an unset run font as unformatted text. Do not rebuild a complex deck through a library that cannot preserve its animations, media, SmartArt, or chart behavior; use a capable native adapter or report the specific limitation before destructive conversion. - Reopen the PPTX to verify slide count, text, notes, chart data, typography, and object bounds. Render every slide, inspect full-size images, fix overlap and clipping, and render affected slides again. XML bounds alone do not catch text overflow.
- Return the PPTX, plus a PDF only when requested. A Google Slides request needs a verified connector import; a local deck alone does not complete that step.