name: pptx description: Work with PowerPoint presentations (PPTX/PPT) - read slides, extract content, create presentations, convert formats, and generate slide decks. Use when the user asks to work with PowerPoint files or presentations. allowed-tools: Read, Bash, Write

PowerPoint (PPTX) Processing Skill

When working with PowerPoint presentations, follow these guidelines:

1. Reading & Extracting from PPTX

Extract text content:

from pptx import Presentation

# Load presentation
prs = Presentation('presentation.pptx')

# Extract all text
for slide_num, slide in enumerate(prs.slides, 1):
    print(f"\n=== Slide {slide_num} ===")
    for shape in slide.shapes:
        if hasattr(shape, 'text'):
            print(shape.text)

Extract with structure:

from pptx import Presentation

prs = Presentation('presentation.pptx')

for slide_num, slide in enumerate(prs.slides, 1):
    print(f"\nSlide {slide_num}:")

    # Title
    if slide.shapes.title:
        print(f"  Title: {slide.shapes.title.text}")

    # Content
    for shape in slide.shapes:
        if shape.has_text_frame:
            for paragraph in shape.text_frame.paragraphs:
                if paragraph.text:
                    print(f"    - {paragraph.text}")

Extract images:

from pptx import Presentation
import os

prs = Presentation('presentation.pptx')
os.makedirs('extracted_images', exist_ok=True)

image_count = 0
for slide in prs.slides:
    for shape in slide.shapes:
        if shape.shape_type == 13:  # Picture
            image = shape.image
            image_bytes = image.blob
            image_filename = f'extracted_images/image_{image_count}.{image.ext}'
            with open(image_filename, 'wb') as f:
                f.write(image_bytes)
            image_count += 1

print(f"Extracted {image_count} images")

Extract notes:

from pptx import Presentation

prs = Presentation('presentation.pptx')

for slide_num, slide in enumerate(prs.slides, 1):
    notes_slide = slide.notes_slide
    notes = notes_slide.notes_text_frame.text if notes_slide else ''
    if notes:
        print(f"Slide {slide_num} notes: {notes}")

2. Creating PPTX Files

Create simple presentation:

from pptx import Presentation
from pptx.util import Inches, Pt

# Create presentation
prs = Presentation()

# Title slide
title_slide_layout = prs.slide_layouts[0]
slide = prs.slides.add_slide(title_slide_layout)
title = slide.shapes.title
subtitle = slide.placeholders[1]
title.text = "Presentation Title"
subtitle.text = "Your Name\n2026-01-22"

# Content slide
bullet_slide_layout = prs.slide_layouts[1]
slide = prs.slides.add_slide(bullet_slide_layout)
shapes = slide.shapes
title_shape = shapes.title
body_shape = shapes.placeholders[1]

title_shape.text = 'Key Points'
text_frame = body_shape.text_frame
text_frame.text = 'First point'

p = text_frame.add_paragraph()
p.text = 'Second point'
p.level = 0

p = text_frame.add_paragraph()
p.text = 'Sub-point'
p.level = 1

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

Create from template:

from pptx import Presentation

# Load template
prs = Presentation('template.pptx')

# Add slides using template layouts
for i in range(5):
    slide_layout = prs.slide_layouts[1]  # Use content layout
    slide = prs.slides.add_slide(slide_layout)
    slide.shapes.title.text = f"Slide {i+1}"

prs.save('from_template.pptx')

Add images and charts:

from pptx import Presentation
from pptx.util import Inches
from pptx.enum.shapes import MSO_SHAPE
from pptx.chart.data import CategoryChartData
from pptx.enum.chart import XL_CHART_TYPE

prs = Presentation()

# Add image slide
blank_layout = prs.slide_layouts[6]
slide = prs.slides.add_slide(blank_layout)

# Add title
title_box = slide.shapes.add_textbox(Inches(0.5), Inches(0.5), Inches(9), Inches(0.5))
title_box.text = "Image Slide"

# Add image
img_path = 'image.jpg'
left = Inches(2)
top = Inches(1.5)
slide.shapes.add_picture(img_path, left, top, width=Inches(5))

# Add chart slide
slide = prs.slides.add_slide(blank_layout)

# Create chart data
chart_data = CategoryChartData()
chart_data.categories = ['Q1', 'Q2', 'Q3', 'Q4']
chart_data.add_series('Sales', (10, 15, 13, 20))

# Add chart
x, y, cx, cy = Inches(1), Inches(1.5), Inches(8), Inches(4.5)
chart = slide.shapes.add_chart(
    XL_CHART_TYPE.COLUMN_CLUSTERED, x, y, cx, cy, chart_data
).chart
chart.has_legend = True

prs.save('presentation.pptx')

3. Converting PPTX

PPTX to PDF:

# Using LibreOffice
libreoffice --headless --convert-to pdf presentation.pptx

# With output directory
libreoffice --headless --convert-to pdf --outdir ./output presentation.pptx

PPTX to Images (PNG/JPG):

# Using LibreOffice (converts to PDF first, then images)
libreoffice --headless --convert-to pdf presentation.pptx
pdftoppm presentation.pdf slides -png

# Or using Python

from pptx import Presentation
import subprocess

# Convert to PDF first
subprocess.run(['libreoffice', '--headless', '--convert-to', 'pdf', 'presentation.pptx'])

# Then PDF to images
subprocess.run(['pdftoppm', '-png', '-r', '300', 'presentation.pdf', 'slides'])

PPTX to HTML:

# Using pandoc (preserves content, not design)
pandoc presentation.pptx -o output.html

# Using LibreOffice
libreoffice --headless --convert-to html presentation.pptx

PPT to PPTX:

# Using LibreOffice
libreoffice --headless --convert-to pptx presentation.ppt

4. Modifying Presentations

Add slide to existing presentation:

from pptx import Presentation

# Load existing
prs = Presentation('existing.pptx')

# Add new slide
slide_layout = prs.slide_layouts[1]
slide = prs.slides.add_slide(slide_layout)
slide.shapes.title.text = "New Slide"

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

Replace text globally:

from pptx import Presentation

def replace_text_in_presentation(pptx_path, search, replace):
    prs = Presentation(pptx_path)

    for slide in prs.slides:
        for shape in slide.shapes:
            if shape.has_text_frame:
                text_frame = shape.text_frame
                for paragraph in text_frame.paragraphs:
                    for run in paragraph.runs:
                        if search in run.text:
                            run.text = run.text.replace(search, replace)

    prs.save(pptx_path)

replace_text_in_presentation('presentation.pptx', '{NAME}', 'John Doe')

Delete slides:

from pptx import Presentation
from lxml import etree

def delete_slide(prs, index):
    # Get slide
    slide = prs.slides[index]

    # Remove from slide list
    rId = prs.slides._sldIdLst[index].rId
    prs.part.drop_rel(rId)
    del prs.slides._sldIdLst[index]

prs = Presentation('presentation.pptx')
delete_slide(prs, 2)  # Delete 3rd slide (0-indexed)
prs.save('presentation.pptx')

5. Formatting & Styling

Text formatting:

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

prs = Presentation()
slide = prs.slides.add_slide(prs.slide_layouts[6])

# Add text box
textbox = slide.shapes.add_textbox(Inches(1), Inches(1), Inches(8), Inches(1))
text_frame = textbox.text_frame

# Add paragraph
p = text_frame.paragraphs[0]
run = p.add_run()
run.text = "Formatted Text"

# Font styling
font = run.font
font.name = 'Arial'
font.size = Pt(32)
font.bold = True
font.italic = False
font.color.rgb = RGBColor(255, 0, 0)

# Paragraph alignment
p.alignment = PP_ALIGN.CENTER

prs.save('formatted.pptx')

Slide background:

from pptx import Presentation
from pptx.util import Inches
from pptx.enum.dml import MSO_THEME_COLOR

prs = Presentation()
slide = prs.slides.add_slide(prs.slide_layouts[6])

# Solid color background
background = slide.background
fill = background.fill
fill.solid()
fill.fore_color.rgb = RGBColor(0, 102, 204)

# Or image background
fill.background()
fill.fore_color.theme_color = MSO_THEME_COLOR.BACKGROUND_1

prs.save('backgrounds.pptx')

Table formatting:

from pptx import Presentation
from pptx.util import Inches
from pptx.enum.text import PP_ALIGN

prs = Presentation()
slide = prs.slides.add_slide(prs.slide_layouts[6])

# Add table
rows, cols = 4, 3
left, top, width, height = Inches(1), Inches(1.5), Inches(8), Inches(3)
table = slide.shapes.add_table(rows, cols, left, top, width, height).table

# Set column widths
table.columns[0].width = Inches(3)
table.columns[1].width = Inches(2.5)
table.columns[2].width = Inches(2.5)

# Add data
headers = ['Product', 'Sales', 'Profit']
data = [
    ['Product A', '$1,000', '$300'],
    ['Product B', '$1,500', '$450'],
    ['Product C', '$800', '$200']
]

# Headers
for i, header in enumerate(headers):
    cell = table.cell(0, i)
    cell.text = header
    cell.text_frame.paragraphs[0].font.bold = True
    cell.text_frame.paragraphs[0].alignment = PP_ALIGN.CENTER

# Data
for i, row_data in enumerate(data, 1):
    for j, value in enumerate(row_data):
        table.cell(i, j).text = value

prs.save('table.pptx')

6. Analyzing Presentations

Get presentation info:

from pptx import Presentation

prs = Presentation('presentation.pptx')

print(f"Slides: {len(prs.slides)}")
print(f"Slide size: {prs.slide_width} x {prs.slide_height}")

# Layout info
print(f"\nAvailable layouts:")
for i, layout in enumerate(prs.slide_layouts):
    print(f"  {i}: {layout.name}")

# Slide content summary
for slide_num, slide in enumerate(prs.slides, 1):
    shapes_count = len(slide.shapes)
    text_count = sum(1 for s in slide.shapes if s.has_text_frame)
    image_count = sum(1 for s in slide.shapes if s.shape_type == 13)

    print(f"\nSlide {slide_num}:")
    print(f"  Shapes: {shapes_count}, Text: {text_count}, Images: {image_count}")

7. Common Workflows

Generate presentation from data

from pptx import Presentation
from pptx.util import Inches
import json

# Load data
with open('data.json') as f:
    data = json.load(f)

prs = Presentation()

# Title slide
title_slide = prs.slides.add_slide(prs.slide_layouts[0])
title_slide.shapes.title.text = data['title']
title_slide.placeholders[1].text = data['subtitle']

# Content slides
for section in data['sections']:
    slide = prs.slides.add_slide(prs.slide_layouts[1])
    slide.shapes.title.text = section['title']

    text_frame = slide.placeholders[1].text_frame
    for point in section['points']:
        p = text_frame.add_paragraph() if text_frame.text else text_frame.paragraphs[0]
        p.text = point
        p.level = 0

prs.save('generated.pptx')

Merge presentations

from pptx import Presentation

def merge_presentations(output_file, *input_files):
    prs = Presentation(input_files[0])

    for pptx_file in input_files[1:]:
        source_prs = Presentation(pptx_file)
        for slide in source_prs.slides:
            # Copy slide (simplified - doesn't preserve all formatting)
            slide_layout = prs.slide_layouts[6]  # Blank
            new_slide = prs.slides.add_slide(slide_layout)

            for shape in slide.shapes:
                # Copy each shape (basic implementation)
                pass  # Full implementation would need detailed shape copying

    prs.save(output_file)

# Usage
merge_presentations('merged.pptx', 'pres1.pptx', 'pres2.pptx')

Extract speaker notes to document

from pptx import Presentation

prs = Presentation('presentation.pptx')

with open('speaker_notes.txt', 'w') as f:
    for slide_num, slide in enumerate(prs.slides, 1):
        notes_slide = slide.notes_slide
        notes = notes_slide.notes_text_frame.text if notes_slide else ''

        # Title
        title = slide.shapes.title.text if slide.shapes.title else f"Slide {slide_num}"

        f.write(f"=== {title} ===\n")
        if notes:
            f.write(f"{notes}\n\n")
        else:
            f.write("(No notes)\n\n")

Tools Required

Install necessary tools:

Linux (Ubuntu/Debian):

sudo apt-get install python3-pip libreoffice poppler-utils
pip3 install python-pptx Pillow

macOS:

brew install libreoffice poppler
pip3 install python-pptx Pillow

Windows:

pip install python-pptx Pillow
# Install LibreOffice manually

Security Notes

✅ Validate file paths and extensions
✅ Check file sizes before processing
✅ Be cautious with macro-enabled presentations (.pptm)
✅ Sanitize user input in text replacements
✅ Validate image sources
✅ Don't execute embedded scripts
✅ Scan files from untrusted sources

When to Use This Skill

Use /pptx when the user:

Wants to read or extract content from PowerPoint files
Needs to create presentations from data or templates
Wants to convert PPTX to other formats (PDF, images, HTML)
Asks to modify existing presentations
Needs to extract speaker notes or images
Wants to merge or split presentations
Asks to generate slide decks programmatically
Needs to analyze presentation structure

Always confirm before overwriting existing presentation files.

pptx

SKILL.md