83.3K+Download
Skip to the usage guide
pptx-generatorby MiniMax

PPTX Generator Skill.

A Claude Code and Codex skill for PPT and slide decks: generates, edits, and reads editable PowerPoint presentations.

  • Presentations
  • PPTX
Download OpenDesignView usage guide
MiniMax-AI/skills · skills/pptx-generator/SKILL.mdSKILL.md
--- name: pptx-generator description: Generate, edit, and read PowerPoint presentations. Create from scratch with PptxGenJS (cover, TOC, content, section divider, summary slides), edit existing PPTX via XML workflows, or extract text with markitdown. Triggers: PPT, PPTX, PowerPoint, presentation, slide, deck, slides. --- ## Creating from Scratch — Workflow ## Slide Output Format ## Theme Object Contract (MANDATORY) ## Page Number Badge (REQUIRED) ## Dependencies
Front matter and section headings read from the upstream file on 2026-09-14 · 7,882 characters in full

01 What it does

What the pptx-generator Skill Does in Claude Code and Codex

Summary, workflow and outputs, all read from the skill's SKILL.md.

From the SKILL.mdRead 2026-09-14 · not a recorded run

In the Skill's Own Terms

Covers the whole PowerPoint surface for coding agents: reading an existing deck's text with markitdown, editing template-based decks through XML workflows, and building decks from scratch with PptxGenJS.

The from-scratch path is a seven-step workflow — gather requirements, pick a palette and font pairing, choose a Sharp, Soft, Rounded or Pill style, classify every slide as one of five page types, generate one synchronous JS module per slide, compile through slides/compile.js, then run the required QA pass. A mandatory theme contract of five exact keys keeps slides consistent, the canvas is 10 by 5.625 inches, and every slide except the cover carries a page number badge.

What it produces

  • One complete, runnable JS file per slide, each exporting createSlide and slideConfig.
  • A slides/compile.js script that requires every slide module and writes the assembled presentation.
  • The finished deck at slides/output/.
  • A per-slide preview PPTX, written under a slide-specific file name when a module is run on its own.
See the example prompt ↗

How It Works

  1. 01
    Read the Source Deck First

    When a presentation already exists, extract its text before touching layout, so the agent is working from real content rather than guesses.

  2. 02
    Choose Palette, Fonts and Design Style

    The design-system reference supplies color palettes, font pairings, style recipes (Sharp, Soft, Rounded, Pill) and typography spacing, all chosen to match the topic and audience.

  3. 03
    Plan the Outline by Page Type

    Every slide must be classified as exactly one of the five page types, with content and layout planned per slide so layouts do not repeat.

  4. 04
    Write One JS Module per Slide

    Slide files live in the slides directory, each exporting a synchronous createSlide(pres, theme) function; up to five can be farmed out to subagents.

  5. 05
    Compile the Modules into One Deck

    A compile script requires every slide module, applies the shared theme object, and writes the finished file.

  6. 06
    Run the Required QA Pass

    Step 7 of the workflow is mandatory and points at the QA process and PptxGenJS pitfalls checklist.

02 Find your fit

When to Use the pptx-generator Skill

Use the pptx-generator skill in Claude Code or Codex when the job is PPT and slide decks of this kind. Fit and limits below are taken from the skill's own file.

Good Fit

  • Any request phrased as PPT, PPTX, PowerPoint, presentation, slide, deck or slides, which are the skill's stated triggers.
  • Reading or analyzing what is already inside an existing presentation rather than rebuilding it.
  • Editing a template-based deck while keeping its existing XML formatting intact.
  • Building a designed deck from code with PptxGenJS when there is nothing to start from.

Know the Boundaries

  • The from-scratch workflow is scoped to cases with no template or reference presentation; with a template on hand, the editing path applies instead.
  • Drawing is limited to four shape primitives: rectangle, oval, line and rounded rectangle.
  • Charts are limited to the seven listed types, so exotic chart forms are outside the documented set.

What to Provide

  • A requirements briefStep 1 asks the agent to research topic, audience, purpose, tone and content depth, so the clearest input is a short statement of those.
  • PptxGenJS available on the machineCreating a presentation from scratch requires the pptxgenjs package to be installed globally.
  • markitdown with pptx supportExtracting text from an existing deck depends on the markitdown pptx extra being installed.
  • Optional icon packagesIcons in slides work only if react-icons, react, react-dom and sharp are installed; the file marks this as optional.

03 Inside the skill

Rules the pptx-generator Skill Gives Claude Code and Codex

8 concrete instructions, defaults and limits the SKILL.md sets for the agent — the part of the file that changes the result.

  1. Use the Five Theme Keys and Nothing Else

    The compile script passes exactly primary, secondary, accent, light and bg. Other names such as background, text, muted, darkest or lightest are explicitly banned.

  2. Badge Every Slide Except the Cover

    The page number badge in the bottom-right corner is required on all slides other than the cover page.

  3. Show the Slide Number Alone

    The badge carries only the current number, as 3 or 03, never a running total such as 3/12.

  4. Keep the 16:9 Canvas

    Slides are 10 by 5.625 inches using LAYOUT_16x9, which the compile script sets as the presentation layout.

  5. Write Colors as Bare Hex

    Colors are 6-character hex strings with no leading hash, for example "FF0000".

  6. Keep createSlide Synchronous

    Each slide module exports a synchronous createSlide(pres, theme) function; async slide functions are not accepted.

  7. Vary the Layouts

    Planning must deliberately avoid repeating the same slide layout across the deck.

  8. Cap Concurrency at Five Slides

    When subagents are available, at most 5 slides may be generated concurrently.

04 Put it to work

Install pptx-generator in Claude Code or Codex

One npx skills add command, then a first task in your agent and a checklist for the result.

Add pptx-generator to Claude Code, Codex or Your Agent

Run in your project; the installer asks which agent to add it to.

Terminal
npx skills add https://github.com/MiniMax-AI/skills --skill pptx-generator

Generic skills CLI form for skills/pptx-generator/SKILL.md; the repository may document its own path.

Give the Skill a First PPT and Slide Decks Task

Written in the skill's own terms; replace the bracketed parts with your material.

Starter prompt
Build a 12-slide deck on [topic] for [audience]. Open with a cover slide, add a table of contents and two section dividers, and keep the layouts varied across the content slides. Use a Soft style with a muted palette and Arial for the English text, and put the page number badge on every slide except the cover.

Source: written from the SKILL.md in the skill's own terms.

Check the First Result

What the SKILL.md itself says a correct result looks like:

  • Walk the QA process in pitfalls.md, which covers common mistakes and the critical PptxGenJS pitfalls.
  • Run a slide module standalone to produce a preview PPTX under a slide-specific filename before compiling everything.
  • Confirm the page number badge sits at x: 9.3", y: 5.1" in the bottom-right corner.
  • For template work, check the result against the editing workflow's formatting rules and its list of common pitfalls.

In OpenDesign pptx-generator is bundled: Plugins → Skills, pick it in the top bar.

Download OpenDesignRead the quickstart

05 Open source, traceable

Source, License and Verification

Where this page's facts come from, and when they were last checked.

Author
MiniMax
Repository
github.com/MiniMax-AI/skills Branch main
Skill file
skills/pptx-generator/SKILL.md Content checksum recorded at verification; commit 60aaae5
License
MIT From LICENSE; SKILL.md says “MIT”.
Repository stars
13,547 GitHub snapshot taken 2026-09-14 for the whole MiniMax-AI/skills repository, which contains 6 skills in this catalog. Not a rating or usage count for pptx-generator.
Verified by OpenDesign
2026-09-14 Source file, path, license text and star count were checked. Bundled in OpenDesign main (checked 2026-08-28); a live run has not been recorded on this page.

Inside the SKILL.md

  1. OverviewScope: read decks, edit templates via XML, or build decks from scratch with a design system.
  2. Quick ReferenceTask-to-approach table plus dimensions, colors, fonts, badge position, theme keys, shapes, charts.
  3. Reference FilesMaps the five companion files: slide types, design system, editing, pitfalls, PptxGenJS API.
  4. Reading ContentSingle markitdown command for pulling text out of an existing presentation.
  5. Creating from Scratch — WorkflowSeven steps: requirements, palette, style, outline, slide modules, compile, QA.
  6. Slide Output FormatStructure of a slide file: config object, synchronous createSlide, standalone preview block.
  7. Theme Object Contract (MANDATORY)Fixes the five theme keys and forbids alternative names like background or text.
  8. Page Number Badge (REQUIRED)Badge rules plus code for the circle and pill variants at a fixed position.
  9. DependenciesInstall commands for markitdown, pptxgenjs, and the optional icon packages.
The Skill's Own Description
“Generate, edit, and read PowerPoint presentations. Create from scratch with PptxGenJS (cover, TOC, content, section divider, summary slides), edit existing PPTX via XML workflows, or extract text with markitdown. Triggers: PPT, PPTX, PowerPoint, presentation, slide, deck, slides.”

Front-matter description from SKILL.md. The full file is about 7,882 characters. Read the full file on GitHub.

06 Before you install

Questions About the pptx-generator Skill

Answers come from the SKILL.md as read on 2026-09-14, not from a recorded run.

Can it edit a deck I already have, or does it only create new ones?

Both. Editing and creating from a template go through a separate workflow documented in the editing reference, which covers XML manipulation, formatting rules and common pitfalls.

Which kinds of slides can it produce?

Five page types are documented: Cover, TOC, Section Divider, Content and Summary, plus additional layout patterns in the slide-types reference.

Is there an API reference for the code it writes?

Yes. Slide modules are expected to follow the PptxGenJS reference file, which the catalog describes as a complete API reference.

PPTX Generator

Run pptx-generator on a Real PPT and Slide Decks Task.

The pptx-generator skill ships inside OpenDesign. Download the app, pick the skill in Plugins → Skills, paste the prompt above, and read the plan before the result.

Download OpenDesignBrowse all skills
Terminal
npx skills add https://github.com/MiniMax-AI/skills --skill pptx-generator