powerpoint

Create, read, and edit .pptx presentations with python-pptx scripts.

Updated Jul 3, 2026
One-click install
npx skills add https://github.com/CHENHUI-X/toolbox --skill powerpoint-chenhui-x
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: powerpoint
Source: https://github.com/CHENHUI-X/toolbox/tree/main/official-skills/productivity/powerpoint
Command: npx skills add https://github.com/CHENHUI-X/toolbox --skill powerpoint-chenhui-x

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python-pptx, lxml, and includes scripts (resource) components.

What problem does it solve? Working with PowerPoint files programmatically is tedious: building decks from scratch, extracting content from shared presentations, and making bulk edits all require manual effort or a PowerPoint installation. This Skill automates the full lifecycle of .pptx files offline using python-pptx. ## Core Features & Use Cases - Deck Creation from JSON Specs: Generate complete presentations with slides, bullets, tables, charts, images, shapes, backgrounds, footers, and speaker notes from a single JSON file. - Structured Reading and Editing: Extract outlines, notes, tables, chart data, and embedded images as JSON, then perform in-place edits like text replacement, chart data updates, image swaps, and slide duplication, removal, or reordering. - Template-Based Brand Decks: Fill {{token}} placeholders in a company template and append slides using the template's own layouts so new content inherits brand fonts and colors. - Use Case: A sales team needs a quarterly review deck. Write a JSON spec with charts and tables, generate the deck, render each slide to PNG for visual verification, and export to PDF with LibreOffice. ## Quick Start Use the powerpoint skill to create a five-slide pitch deck from a JSON spec and render each slide to PNG for review.

Frequently Asked Questions about powerpoint

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a PowerPoint presentation with Python?

Write a JSON spec defining slides with layouts, titles, bullets, tables, charts, and images, then run pptx_create.py with the spec and an output path. The script builds the .pptx using python-pptx and prints a JSON report with the slide count.

How to extract text and images from a .pptx file?

Run pptx_read.py with --outline to get a JSON outline of all slide texts, tables, charts, and notes, or use --images DIR to export every embedded picture to files. Grouped shapes are traversed recursively so nested content is included.

Does python-pptx work without Microsoft PowerPoint installed?

Yes, python-pptx reads and writes .pptx files entirely offline with no PowerPoint installation. Rendering slides to PNG or exporting PDF additionally requires LibreOffice (soffice) and poppler (pdftoppm or pdftocairo).

Can I convert legacy .ppt files with python-pptx?

No, python-pptx only supports the .pptx format. Convert legacy .ppt files first with soffice --convert-to pptx if LibreOffice is available, then process the converted file normally.

Why can't I duplicate a slide that contains a chart?

Each chart relationship embeds a separate XLSX workbook part that cannot be cloned reliably, so the duplicate operation refuses chart slides to avoid corrupting the deck. Rebuild the chart on a new slide with the create or template scripts instead.

How do I update chart data in an existing PowerPoint deck?

Pass a JSON spec to pptx_edit.py --chart-data with the slide index, categories, and series for a full replace, or use surgical ops like update_series, add_series, remove_series, and rename_category. python-pptx replaces the whole dataset, so ops read existing data, modify it, and write it back.