Pptx

What Is Pptx?

The "Pptx" skill is a specialized toolset designed for creating, editing, and analyzing Microsoft PowerPoint presentation files (.pptx). It is part of the Claude Code skill collection and provides developers and technical users with robust capabilities to automate and manipulate presentations programmatically. The skill can handle a variety of tasks, including generating new presentations, modifying content, interacting with layouts, and working directly with advanced features such as comments, speaker notes, and slide designs. Under the hood, a .pptx file is essentially a ZIP archive containing structured XML files and associated resources (such as images and media), making it possible to access and alter almost every aspect of a presentation via code.

Why Use Pptx?

Modern workflows often require automation and batch processing of presentation files—tasks that are time-consuming or error-prone when performed manually. The Pptx skill provides a programmatic interface for:

• Batch creation of presentations from templates or data sources.
• Bulk editing of slide content, layouts, or formatting.
• Extracting and analyzing text, speaker notes, and metadata for reporting or compliance.
• Customizing presentations with comments, speaker notes, or interactive elements.
• Integrating presentations into larger automation pipelines for document generation or archival.

By leveraging Pptx, users can dramatically reduce manual effort, enforce consistency, and unlock new possibilities for data-driven presentation management.

How to Get Started

To begin using the Pptx skill, you will need access to the source repository and relevant scripts. The skill is available at mrgoonie/claudekit-skills, and usage is subject to the terms in the included LICENSE.txt file.

Basic Steps:

1. Clone the repository:

   bash

   git clone https://github.com/mrgoonie/claudekit-skills.git
   cd claudekit-skills/.claude/skills/document-skills/pptx

2. Install dependencies as required by the documentation (typically python-docx, lxml, or similar libraries for XML and Office document handling).

3. Run scripts to perform desired operations, such as converting, unpacking, or editing .pptx files.

Example: Extracting Presentation Text as Markdown

python -m markitdown path-to-file.pptx > output.md

This command converts the contents of a presentation into markdown format for easy reading, editing, or analysis.

Example: Unpacking a .pptx File

python ooxml/scripts/unpack.py path-to-file.pptx output_directory/

The unpack.py script extracts all internal XML and resource files from the .pptx archive to the specified directory.

Key Features

The Pptx skill provides a comprehensive feature set for advanced presentation management:

• Text Extraction: Quickly obtain all textual content from slides for indexing or analysis.
• Raw XML Access: Directly read or modify the underlying XML, enabling fine control over elements such as:
  • Comments and speaker notes
  • Slide layouts and master slides
  • Animations and transitions
  • Embedded media and design elements
• Content Editing: Programmatically add, remove, or update slide content, including text boxes, images, tables, and charts.
• Presentation Generation: Automate the creation of new .pptx files from templates or data sources, supporting batch workflows.
• Metadata and Structure Analysis: Extract and analyze presentation properties, slide order, and embedded objects.

Example: Locating a Key XML File After extracting a presentation:

ls output_directory/ppt/
## presentation.xml, slides/, slideLayouts/, slideMasters/, notesSlides/

For advanced editing, you may open and manipulate presentation.xml or any slide-specific XML file using Python libraries like lxml.

Best Practices

To maximize the effectiveness and reliability of the Pptx skill, consider the following best practices:

• Work on Copies: Always operate on copies of original presentations to prevent accidental data loss.
• Validate Output: After automated edits, open resulting files in PowerPoint to ensure compatibility and correct rendering.
• Leverage Templates: For consistent branding or formatting, start from a standardized template when generating new presentations.
• Automate Repetitive Tasks: Use batch scripts to process multiple files, reducing manual intervention and errors.
• Document Your Workflow: Maintain clear documentation of your scripts and processing steps for reproducibility and troubleshooting.
• Use Version Control: Track changes to scripts and, if practical, to .pptx files themselves using a version control system like Git.

Important Notes

• File Structure Knowledge is Essential: Understanding the internal XML schema of .pptx files (Office Open XML) is crucial for advanced operations. Key files include:
  • ppt/presentation.xml (main structure)
  • ppt/slides/slideX.xml (individual slides)
  • ppt/notesSlides/notesSlideX.xml (speaker notes)
• Script Paths May Vary: The location of utility scripts, such as unpack.py, can differ based on repository structure. Use find . -name "unpack.py" to locate them if necessary.
• Proprietary License: The Pptx skill is distributed under a proprietary license. Review LICENSE.txt before use to ensure compliance.
• PowerPoint Compatibility: Not all automated edits are guaranteed to display identically in all versions of PowerPoint. Always test outputs in the intended environment.
• Error Handling: When manipulating XML directly, ensure robust error handling to avoid corrupting files.

By following these guidelines and leveraging the powerful features of the Pptx skill, users can efficiently automate and customize PowerPoint presentation workflows at scale.