Skip to content
SkillScript-led7,017 tokens in use

pptx

Anthropic's PowerPoint skill: build themed decks with pptxgenjs, edit templates at the XML level, read slide text, and render and validate every file.

197,764 stars on the repositoryanthropics/skills · skills/pptx
/plugin install document-skills@anthropic-agent-skills
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing pptx costs

171tokens idle
7,017tokens in use

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Counts are approximate, made offline with cl100k_base.

Model dependence Script-led

Script-ledMixedModel-led

Most of this skill is scripts, so it behaves much the same whichever model runs it.

This describes the skill's structure, how much of it is scripts. It does not say how well it works. Scripts: scripts/__init__.py, scripts/add_slide.py, scripts/apply_theme.js, scripts/clean.py, scripts/office/helpers/__init__.py, scripts/office/helpers/pptx_chart.py, scripts/office/helpers/pptx_slide.py, scripts/office/helpers/pptx_theme.py, scripts/office/soffice.py, scripts/office/validate.py, scripts/office/validators/__init__.py, scripts/office/validators/base.py, scripts/office/validators/docx.py, scripts/office/validators/pptx.py, scripts/office/validators/redlining.py, scripts/slide_text.py, scripts/thumbnail.py.

Touches

shelldetectedwrites filesdetected

Declared tags come from the skill's frontmatter; detected ones from its scripts and code blocks. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Good
  • Frontmatter15/15
  • Structure19/25
  • Examples12/15
  • Output15/15
  • Size11/15
  • Resources6/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Excellent
  • Runs shell commands−5

    does this on the machine, and the frontmatter does not say so

    SKILL.md, line 74
  • Writes files−8

    does this on the machine, and the frontmatter does not say so

    SKILL.md, line 79

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Good
  • Development activity72
  • Maintenance32
  • Community68
  • Maturity36
  • Momentum40

The pptx skill is the PowerPoint guide from Anthropic’s public skills repository, one of the document skills that power Claude’s file creation features. It triggers whenever a .pptx or .potx file is involved, or the user mentions a deck, slides or a presentation, and picks the approach by task: write a pptxgenjs script to create a new deck, unpack the archive and edit ppt/slides/slideN.xml to change an existing deck or fill a template, and run slide_text.py or thumbnail.py to read one.

Much of the guide is a list of pptxgenjs footguns, from hex colors with a # that corrupt the file to shared option objects, negative shadow offsets and stacked-chart label positions. It asks for structured decks built on a theme, named layouts, placeholders and sections, with apply_theme.js writing the theme’s colors into the file afterwards. It then covers deck structure, design ideas with palettes, safe fonts and a list of things to avoid, and a required QA pass: slide text checks, validate.py, and a render to images with LibreOffice and pdftoppm to look at every slide.

What You Get

  • A SKILL.md guide with a task table for creating, editing and reading .pptx and .potx files
  • A list of pptxgenjs gotchas covering layout size, hex colors, shadows, lists, charts, combo axes, icons, slide layouts and unescaped XML
  • A structured-deck method: a theme object, scheme colors, sections, one layout per slide frame and placeholders filled by name
  • slide_text.py, which prints every slide’s title, text, tables, chart data, alt text and speaker notes as markdown
  • thumbnail.py, which renders a labeled grid of slides for picking template layouts
  • add_slide.py and clean.py, which duplicate slides or layouts with all the package bookkeeping and remove orphaned slides, media and relationships
  • apply_theme.js, which writes the theme’s colors and name into a pptxgenjs deck
  • validate.py, which checks schemas, relationships, content types, charts and slides and names a fix for each failure
  • Design guidance: palettes, typography with QA-safe fonts, spacing, and a list of common mistakes to avoid

Common Use Cases

  • Building a new pitch deck or report deck with native charts, icons and speaker notes
  • Filling a company template with new content while keeping its layouts and styling
  • Extracting the text, tables and notes from a deck to use in a summary or email
  • Adding, duplicating, reordering or deleting slides in an existing presentation
  • Converting a legacy .ppt to .pptx, or rendering a deck to images to check it

What Makes It Unique

Like the docx and pdf skills from the same repository, it is Anthropic’s own reference for a complex skill used in production, and like docx it splits the work by whether the file exists yet: pptxgenjs for new decks, direct XML edits for existing ones and templates. Where those skills stop at producing a valid file, this one also has opinions about the deck itself: one message per slide, a theme-and-layout structure that can be restyled in one place, palettes, fonts chosen so the LibreOffice preview measures text the way PowerPoint will, and a list of patterns that read as AI-generated slides. Its validator targets faults PowerPoint refuses but other tools accept, such as chart XML pptxgenjs writes.

Under The Hood

The guide has the agent write and run its own Node script requiring pptxgenjs, which it expects to be preinstalled and installs from npm only if the require fails, and the same for react-icons, react, react-dom and sharp when it renders icons. It shells out to Python, zip, pdftoppm and LibreOffice. slide_text.py reads a deck with python-pptx and prints it. thumbnail.py renders the deck to PDF and JPEG pages in a temporary folder and writes the grid images to the working directory. add_slide.py writes new slide parts and edits the content types, relationships, presentation.xml and app.xml; given a .pptx without -o it rewrites that file in place. clean.py deletes slides, media, notes, themes and relationships nothing references in an unpacked folder, and refuses when it cannot resolve the relationships. apply_theme.js loads the deck with jszip, rewrites its theme part, mends one chart fault, drops ZIP folder entries and writes the deck back. validate.py unpacks with a safe extractor that refuses symlinks and paths outside the target folder, and with —auto-repair writes fixes back into the file. soffice.py runs LibreOffice headless; before rendering it copies the deck with links to outside files cut, and where the sandbox blocks Unix sockets it writes a small C shim to the temp folder, compiles it with gcc and loads it with LD_PRELOAD. The shared office folder also carries the docx and redlining validators, which this skill does not use.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers