fatby/PowerPoint PPTX

When to Use

User needs to create or modify PowerPoint (.pptx) files programmatically. Agent handles slide creation, content population, chart generation, and template automation.

Quick Reference

| Topic | File | |-------|------| | Slide patterns | slides.md | | Charts and tables | charts.md | | Design guidelines | design.md |

Core Rules

1. Use python-pptx Library

from pptx import Presentation
from pptx.util import Inches, Pt
from pptx.enum.text import PP_ALIGN
from pptx.dml.color import RgbColor

Install: pip install python-pptx

2. Presentation Structure

# Create new presentation
prs = Presentation()

# Or load existing template
prs = Presentation('template.pptx')

# Add slide with layout
slide_layout = prs.slide_layouts[1]  # Title and Content
slide = prs.slides.add_slide(slide_layout)

# Save
prs.save('output.pptx')

3. Slide Layouts (Built-in)

| Index | Layout Name | Use Case | |-------|-------------|----------| | 0 | Title Slide | Opening slide | | 1 | Title and Content | Standard content | | 2 | Section Header | Chapter dividers | | 3 | Two Content | Side-by-side | | 4 | Comparison | Before/after | | 5 | Title Only | Custom content | | 6 | Blank | Full control |

4. Text Handling

# Access title
title = slide.shapes.title
title.text = "Slide Title"

# Access body placeholder
body = slide.placeholders[1]
tf = body.text_frame
tf.text = "First paragraph"

# Add more paragraphs
p = tf.add_paragraph()
p.text = "Second paragraph"
p.level = 1  # Indent level

5. Always Verify Output

After creating presentation:

1. Check slide count matches expectation
2. Verify text populated correctly
3. Test charts render properly
4. Save to user-specified path

Common Traps

• Layout index assumption: Layout indices vary by template. Always check prs.slide_layouts first.
• Missing placeholders: Not all layouts have body placeholders. Use slide.shapes iteration to find shapes.
• Font not embedding: python-pptx uses system fonts. Stick to common fonts (Arial, Calibri) for portability.
• Image sizing: Always specify dimensions with Inches() or Pt(). Default sizing can be unpredictable.
• Chart data mismatch: Category count must match data series length exactly.

Scope

This skill ONLY:

• Creates and modifies local .pptx files
• Uses python-pptx library for manipulation
• Reads templates from local filesystem

This skill NEVER:

• Uploads presentations to cloud services
• Makes network requests
• Accesses files outside the working directory without user permission

Security & Privacy

Data that stays local:

• All presentations created/modified on local filesystem
• No telemetry or external calls

This skill does NOT:

• Send presentation content externally
• Access cloud storage APIs
• Store user data persistently

Related Skills

Install with clawhub install <slug> if user confirms:

• excel-xlsx — spreadsheet automation
• word-docx — document generation
• report — structured report creation
• documents — document management

Feedback

• If useful: clawhub star powerpoint-pptx
• Stay updated: clawhub sync