pptx

What it does

Automates creation, editing, and analysis of PowerPoint presentations (.pptx). It supports creating or modifying slides, layouts, content, speaker notes, and comments, and includes workflows for converting HTML to PPTX, extracting text, and accessing raw XML within the OOXML structure. It also outlines procedures to generate schematics and incorporate visual diagrams into presentations.

How it works

• Treats a .pptx file as a ZIP with XML resources and enables create/edit/analyze operations through text extraction, raw XML access, or html2pptx workflows.
• For schematics: if document lacks diagrams, it uses a separate workflow to generate publication-quality diagrams via a script, described as: ```bash python scripts/generate_schematic.py "your diagram description" -o figures/output.png

- For text extraction: converts documents to Markdown via: ```bash
python -m markitdown path-to-file.pptx

• For raw XML access and unpacking: uses unpacking script at: python ooxml/scripts/unpack.py <office_file> <output_dir>
• It lists key OOXML structures to inspect when analyzing slides and notes, including ppt/presentation.xml, ppt/slides/slide{N}.xml, ppt/notesSlides/notesSlide{N}.xml, ppt/comments/modernComment_*.xml, ppt/slideLayouts/, ppt/slideMasters/, ppt/theme/, and ppt/media/.
• It provides a design-focused workflow for creating new presentations from HTML via html2pptx: create HTML slides, then convert with html2pptx() and render charts/tables using PptxGenJS via pptx.writeFile(); then validate thumbnails using python scripts/thumbnail.py and iteratively adjust margins, spacing, and colors.
• It also details a template-based workflow for editing/creating presentations using OOXML templates and a multi-step process to extract, inventory, map layouts, and generate an outline.md for template mappings.

When to use it

• When you need programmatic creation or modification of PPTX files, including slides, layouts, content, and notes.
• When you must read or modify the underlying OOXML XML for slides, notes, and media.
• When converting HTML content into a PPTX presentation using an html2pptx workflow.
• When adding technical schematics/diagrams to presentations and ensuring accessibility and visual consistency.

What it can touch

• Interacts with PowerPoint MS Office Open XML components via:
  • ppt/presentation.xml (main metadata),
  • ppt/slides/slide{N}.xml (slide contents),
  • ppt/notesSlides/notesSlide{N}.xml (speaker notes),
  • ppt/comments/modernComment_*.xml (comments),
  • ppt/slideLayouts/, ppt/slideMasters/, ppt/theme/, ppt/media/,
  • Tools/scripts: python ooxml/scripts/unpack.py, python ooxml/scripts/validate.py, python ooxml/scripts/pack.py, as well as html2pptx.js and PptxGenJS API usage in the workflow.

Caveats

• License is Proprietary; LICENSE.txt has complete terms.
• The skill describes adding schematic generation and accessibility steps but requires external scripts and tools (e.g., scientific-schematics skill, generate_schematic.py).
• It mandates reading and processing full files (e.g., html2pptx.md, ooxml.md) without range limits before proceeding.
• It emphasizes design guidance such as typography constraints, color palettes, and layout recommendations, and requires adherence to these when creating presentations.