pptx skill
scriptsCreate, read, edit, and analyze PowerPoint presentations using Python and Node.js tools.
- GitHub stars
- 15,804
- Files
- 59
- Last commit
- Nov 11, 2026
- License
- Apache-2.0
- Allowed tools
- —
What does the pptx skill do?
pptx is an agent skill. Create, read, edit, and analyze PowerPoint presentations using Python and Node.js tools.
Summary generated from the skill's SKILL.md.
About the pptx skill
Managing presentation files is what this skill enables for developers and AI agents. It provides a comprehensive toolkit to create, read, edit, and analyze PowerPoint files using Python and Node.js. An agent should load this skill whenever a user mentions a deck, slides, or a specific .pptx filename, whether the goal is to extract text for a summary or to build a new pitch deck from scratch.
The skill utilizes markitdown for text extraction and pptxgenjs for generating new presentations when no template exists. For existing files, it supports an editing workflow that involves unpacking XML, manipulating slides, and repacking the content. It also includes specialized tools like thumbnail.py for visual overviews and soffice for converting presentations into images via PDF for visual quality assurance. This allows for a rigorous verification loop where slides are rendered, inspected, and fixed until they meet design standards.
What an agent can do with it
- 1Extract text from slidesAn agent can parse a PowerPoint file to pull out text for use in other documents.
- 2Generate new presentationsDevelopers can instruct an AI to build a slide deck from the ground up when no template is provided.
- 3Modify existing slide decksYou can update or edit content within an established presentation file.
- 4Perform visual quality checksThe skill can convert slides into images to allow for visual inspection and bug hunting.
Written from the skill's SKILL.md. Every use case is checked against a quote from it.
How to install the pptx skill
Each command copies the skill folder into the client's skills directory. Restart the client or start a new session to load it.Install the pptx skill in Claude Code
~/.claude/skills/pptx/SKILL.md
$ npx degit eigent-ai/eigent/resources/example-skills/pptx ~/.claude/skills/pptxInstall the pptx skill in Claude Code (project)
.claude/skills/pptx/SKILL.md
$ npx degit eigent-ai/eigent/resources/example-skills/pptx .claude/skills/pptxInstall the pptx skill in Codex
~/.agents/skills/pptx/SKILL.md
$ npx degit eigent-ai/eigent/resources/example-skills/pptx ~/.agents/skills/pptxInstall the pptx skill in Gemini CLI
~/.gemini/skills/pptx/SKILL.md
$ npx degit eigent-ai/eigent/resources/example-skills/pptx ~/.gemini/skills/pptxInstall the pptx skill in Claude.ai
npx degit eigent-ai/eigent/resources/example-skills/pptx pptx && zip -r pptx.zip pptx # claude.ai → Customize → Skills → + → Create skill → Upload a skill → pptx.zip
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A skill needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableeigent-ai/eigent/resources/example-skills/pptx is public and reachablegithub.com/eigent-ai/eigent/tree/HEAD/resources/example-skil ↗Pass
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit 2026-11-11github.com/eigent-ai/eigent/commits ↗Pass
- No download-and-run or credential theft in scripts5 of 16 scripts read; none of them downloads and runs code, the rest were not readFinding
- No hidden instructions in SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/eigent-ai/eigent/blob/HEAD/resources/example-skil ↗Pass
- Pre-approved tools are scopedNo pre-approved tools; the agent asks before using onegithub.com/eigent-ai/eigent/blob/HEAD/resources/example-skil ↗Pass
- SKILL.md follows the Agent Skills formatValid name and description; says when to use it; 203 linesgithub.com/eigent-ai/eigent/blob/HEAD/resources/example-skil ↗Pass
SKILL.md
View on GitHubPPTX Skill
Quick Reference
| Task | Guide |
|---|---|
| Read/analyze content | python -m markitdown presentation.pptx |
| Edit or create from template | Read editing.md |
| Create from scratch | Read pptxgenjs.md |
Reading Content
# Text extraction
python -m markitdown presentation.pptx
# Visual overview
python scripts/thumbnail.py presentation.pptx
# Raw XML
python scripts/office/unpack.py presentation.pptx unpacked/
Editing Workflow
Read editing.md for full details.
- Analyze template with
thumbnail.py - Unpack → manipulate slides → edit content → clean → pack
Creating from Scratch
Read pptxgenjs.md for full details.
Use when no template or reference presentation is available.
Design Ideas
Don't create boring slides. Plain bullets on a white background won't impress anyone. Consider ideas from this list for each slide.
Before Starting
- Pick a bold, content-informed color palette: The palette should feel designed for THIS topic. If swapping your colors into a completely different presentation would still "work," you haven't made specific enough choices.
- Dominance over equality: One color should dominate (60-70% visual weight), with 1-2 supporting tones and one sharp accent. Never give all colors equal weight.
- Dark/light contrast: Dark backgrounds for title + conclusion slides, light for content ("sandwich" structure). Or commit to dark throughout for a premium feel.
- Commit to a visual motif: Pick ONE distinctive element and repeat it — rounded image frames, icons in colored circles, thick single-side borders. Carry it across every slide.
Color Palettes
Choose colors that match your topic — don't default to generic blue. Use these palettes as inspiration:
| Theme | Primary | Secondary | Accent |
|---|---|---|---|
| Midnight Executive | 1E2761 (navy) |
CADCFC (ice blue) |
FFFFFF (white) |
| Forest & Moss | 2C5F2D (forest) |
97BC62 (moss) |
F5F5F5 (cream) |
| Coral Energy | F96167 (coral) |
F9E795 (gold) |
2F3C7E (navy) |
| Warm Terracotta | B85042 (terracotta) |
E7E8D1 (sand) |
A7BEAE (sage) |
| Ocean Gradient | 065A82 (deep blue) |
1C7293 (teal) |
21295C (midnight) |
| Charcoal Minimal | 36454F (charcoal) |
F2F2F2 (off-white) |
212121 (black) |
| Teal Trust | 028090 (teal) |
00A896 (seafoam) |
02C39A (mint) |
| Berry & Cream | 6D2E46 (berry) |
A26769 (dusty rose) |
ECE2D0 (cream) |
| Sage Calm | 84B59F (sage) |
69A297 (eucalyptus) |
50808E (slate) |
| Cherry Bold | 990011 (cherry) |
FCF6F5 (off-white) |
2F3C7E (navy) |
For Each Slide
Every slide needs a visual element — image, chart, icon, or shape. Text-only slides are forgettable.
Layout options:
- Two-column (text left, illustration on right)
- Icon + text rows (icon in colored circle, bold header, description below)
- 2x2 or 2x3 grid (image on one side, grid of content blocks on other)
- Half-bleed image (full left or right side) with content overlay
Data display:
- Large stat callouts (big numbers 60-72pt with small labels below)
- Comparison columns (before/after, pros/cons, side-by-side options)
- Timeline or process flow (numbered steps, arrows)
Visual polish:
- Icons in small colored circles next to section headers
- Italic accent text for key stats or taglines
Typography
Choose an interesting font pairing — don't default to Arial. Pick a header font with personality and pair it with a clean body font.
| Header Font | Body Font |
|---|---|
| Georgia | Calibri |
| Arial Black | Arial |
| Calibri | Calibri Light |
| Cambria | Calibri |
| Trebuchet MS | Calibri |
| Impact | Arial |
| Palatino | Garamond |
| Consolas | Calibri |
| Element | Size |
|---|---|
| Slide title | 36-44pt bold |
| Section header | 20-24pt bold |
| Body text | 14-16pt |
| Captions | 10-12pt muted |
Spacing
- 0.5" minimum margins
- 0.3-0.5" between content blocks
- Leave breathing room—don't fill every inch
Avoid (Common Mistakes)
- Don't repeat the same layout — vary columns, cards, and callouts across slides
- Don't center body text — left-align paragraphs and lists; center only titles
- Don't skimp on size contrast — titles need 36pt+ to stand out from 14-16pt body
- Don't default to blue — pick colors that reflect the specific topic
- Don't mix spacing randomly — choose 0.3" or 0.5" gaps and use consistently
- Don't style one slide and leave the rest plain — commit fully or keep it simple throughout
- Don't create text-only slides — add images, icons, charts, or visual elements; avoid plain title + bullets
- Don't forget text box padding — when aligning lines or shapes with text edges, set
margin: 0on the text box or offset the shape to account for padding - Don't use low-contrast elements — icons AND text need strong contrast against the background; avoid light text on light backgrounds or dark text on dark backgrounds
- NEVER use accent lines under titles — these are a hallmark of AI-generated slides; use whitespace or background color instead
QA (Required)
Assume there are problems. Your job is to find them.
Your first render is almost never correct. Approach QA as a bug hunt, not a confirmation step. If you found zero issues on first inspection, you weren't looking hard enough.
Content QA
python -m markitdown output.pptx
Check for missing content, typos, wrong order.
When using templates, check for leftover placeholder text:
python -m markitdown output.pptx | grep -iE "xxxx|lorem|ipsum|this.*(page|slide).*layout"
If grep returns results, fix them before declaring success.
Visual QA
Verification Loop
- Generate slides → Convert to images → Inspect
- List issues found (if none found, look again more critically)
- Fix issues
- Re-verify affected slides — one fix often creates another problem
- Repeat until a full pass reveals no new issues
Do not declare success until you've completed at least one fix-and-verify cycle.
Converting to Images
Convert presentations to individual slide images for visual inspection:
python scripts/office/soffice.py --headless --convert-to pdf output.pptx
pdftoppm -jpeg -r 150 output.pdf slide
This creates slide-01.jpg, slide-02.jpg, etc.
To re-render specific slides after fixes:
pdftoppm -jpeg -r 150 -f N -l N output.pdf slide-fixed
Dependencies
pip install "markitdown[pptx]"- text extractionpip install Pillow- thumbnail gridsnpm install -g pptxgenjs- creating from scratch- LibreOffice (
soffice) - PDF conversion (auto-configured for sandboxed environments viascripts/office/soffice.py) - Poppler (
pdftoppm) - PDF to images
Files in this skill
59pptx skill questions
How do I install the pptx skill in Claude Code?
Run npx degit eigent-ai/eigent/resources/example-skills/pptx ~/.claude/skills/pptx. Claude Code loads skills from ~/.claude/skills (all projects) or .claude/skills (one project) and uses a skill when its description matches the task.
Which clients can use the pptx skill?
Any client that reads the Agent Skills format: Claude Code, Codex, Gemini CLI and claude.ai (upload as a ZIP). Scripts in the skill run only where the client allows code execution.
How can I extract text from a PowerPoint file?
You can use the markitdown module to perform text extraction by running python -m markitdown presentation.pptx.