Skip to main content
skill CX Codex

pptx · happycapy-ai — Claude Code skill for PowerPoint presentations

Create a PowerPoint deck from a topic or content brief. The skill saves the finished .pptx file in outputs/.

MIT ★ 138 updated 2026-09-03

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add happycapy-ai/Happycapy-skills --skill pptx -a claude-code
Open on GitHub

What pptx does

The skill first drafts the deck in HTML to establish its color palette, slide structure, text, and layout. It then reads the theme and uses Builder from scripts/pptx_builder.py to create the PowerPoint file. The HTML stays internal.

The finished .pptx goes to outputs/, and the build script runs with python3 tmp/<name>-build.py. Slides use a 16:9 layout, with one heading and up to 6 bullets or 6 cards per slide. The workflow depends on scripts/pptx_builder.py; without that file, the documented build step cannot run.

What it helps with

  • turn a topic into a PowerPoint deck
  • convert a content brief into slides
  • apply a shared color theme across slides
  • arrange key points in cards or split columns

Example prompts for the agent

  • Create a PowerPoint deck about the product launch and save it in outputs/.
  • Turn this project brief into a presentation with a cover slide and content slides.
  • Build a deck from these notes, using cards for the key points.

How to install pptx

1Skills CLI (Vercel)

npx skills add happycapy-ai/Happycapy-skills --skill pptx -a claude-code

2Manually: put the files in place

~/.claude/skills/pptx/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/pptx/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about pptx

How do I install pptx in Claude Code?

Run npx skills add happycapy-ai/Happycapy-skills --skill pptx -a claude-code. The skill file is at ~/.claude/skills/pptx/SKILL.md.

What does the pptx skill do?

It builds a PowerPoint presentation from a topic or content brief and saves the .pptx file in outputs/.

How does pptx build the slides?

It creates an internal HTML draft, extracts its color theme, then builds the deck with Builder from scripts/pptx_builder.py. The HTML is not delivered to the user.

Source text

SKILL.md · MIT
---
name: pptx
description: >
  Create polished PowerPoint (.pptx) presentations directly from a topic or content description.
  Uses HTML as an invisible internal design intermediate — the HTML is never shown to the user.
  The final and only deliverable is a .pptx file saved to outputs/.
  Use this skill whenever the user asks to: make a PPT / PowerPoint / 幻灯片 / 演示文稿,
  generate slides about a topic, or turn any content into a presentation deck.
  Supports Chinese and English. Always outputs .pptx, never HTML.
---

# PPTX Skill

Generate a polished PPTX in three phases. The HTML draft is purely internal — never reference or expose it to the user.

## Phase 1 — Design the HTML Draft (Internal only)

Write a single self-contained HTML presentation to `tmp/<name>-draft.html`.

**Design principles:**
- Choose a bold, distinctive aesthetic (dark editorial, pastel geometry, neon cyber, etc.)
- Define a CSS `:root {}` block with named color variables: `--bg`, `--bg1`, `--bg2`, `--text`, `--muted`, `--accent`, `--dim`, etc. Use hex values only.
- Each `<section class="slide" id="sN">` is one slide. Viewport-locked `100vh`, scroll-snap, no overflow.
- Use Google Fonts — avoid Inter/Roboto. Good choices: Fraunces, DM Sans, Syne, Outfit, Cormorant.
- Staggered reveal animations are fine for the HTML but irrelevant to PPTX.

This HTML serves one purpose: capture **color theme + slide structure + text content + layout intent** before building the PPTX.

## Phase 2 — Extract Theme & Build PPTX

1. Read `tmp/<name>-draft.html`
2. Extract the CSS color theme using `extract_theme_from_html()` from `scripts/pptx_builder.py`
3. Write a one-off build script to `tmp/<name>-build.py`:
   - Import `Builder` from `scripts/pptx_builder.py` (add skills scripts dir to sys.path)
   - Instantiate `Builder(theme)` with the extracted colors
   - Recreate each HTML slide using Builder primitives
   - Save to `outputs/<name>.pptx`
4. Run: `python3 tmp/<name>-build.py`

### sys.path setup (always required)
```python
import sys
sys.path.insert(0, "/home/node/.claude/skills/pptx/scripts")
from pptx_builder import Builder, extract_theme_from_html
from pptx.util import Inches, Pt
from pptx.enum.text import PP_ALIGN

html = open("tmp/deck-draft.html").read()
theme = extract_theme_from_html(html)   # {"bg":"#0b0b0b", "accent":"#c9a84c", ...}
b = Builder(theme)
```

### Builder API
```python
slide = b.new_slide()              # blank slide with bg fill

# Shapes
b.rect(slide, x, y, w, h, fill="bg1", border="dim")
b.hline(slide, x, y, w, color="accent")
b.oval(slide, x, y, w, h, fill="bg1")
b.card(slide, x, y, w, h)         # shortcut for bg1 card with border

# Text
b.txt(slide, "text", x, y, w, h,
      size=14, bold=False, italic=False,
      color="text",               # theme key or "#hexcode"
      align=PP_ALIGN.LEFT)

b.multicolor_txt(slide, [         # mixed colors in one line
    {"text": "White ",  "size": 52, "bold": True, "color": "text"},
    {"text": "Gold",    "size": 52, "bold": True, "italic": True, "color": "accent"},
], x, y, w, h, align=PP_ALIGN.LEFT)

# Helpers
b.eyebrow(slide, "LABEL", x, y)   # small gold uppercase label
b.logo(slide, "Name", x, y)
b.slide_number(slide, n=1, total=9)

# Grid of cards
b.grid_cards(slide, items, x0, y0, card_w, card_h, gap,
             cols=4, draw_fn=fn)  # fn(slide, b, item, cx, cy, cw, ch)

b.save("outputs/deck.pptx")
```

**Color keys:** any key from the theme dict (`"bg"`, `"bg1"`, `"text"`, `"muted"`, `"accent"`, `"dim"`, etc.) or a raw `"#rrggbb"` string.

## Phase 3 — Deliver

- Attach `outputs/<name>.pptx` in the `<attachments>` block
- Do NOT mention the HTML draft or tmp files
- The user should only see the PPTX as output

## PPTX Layout Conventions

**Slide size:** 13.33 × 7.5 in (16:9). Set automatically by Builder.

| Slide type | Approach |
|---|---|
| Cover | Oversized multicolor title (Pt 100–130), gold rule, tagline below |
| Content | Eyebrow + heading + description + card grid |
| Split | Left column: text + bullets. Right column: visual card panel |
| Quote | Centered quote Pt 44–60, accent line above |
| CTA | Centered heading + description + gold button rect + stats row |

**Limits per slide:** 1 heading, max 6 bullets, max 6 cards in a grid.

## Common Patterns

**Cover with giant title:**
```python
s = b.new_slide()
b.multicolor_txt(s, [
    {"text": "My ",  "size": 120, "bold": True, "color": "text"},
    {"text": "Brand", "size": 120, "bold": True, "color": "accent"},
], Inches(0.8), Inches(1.0), Inches(12), Inches(3.5))
b.hline(s, Inches(0.8), Inches(4.8), Inches(2.5))
b.txt(s, "Tagline text here", Inches(0.8), Inches(5.1), Inches(7), Inches(0.9),
      size=16, color="muted")
b.slide_number(s, 1, 9)
```

**Card grid:**
```python
items = [("📝", "Title", "Description"), ...]

def draw(slide, b, item, cx, cy, cw, ch):
    ico, lbl, desc = item
    b.txt(slide, ico,  cx+Inches(0.2), cy+Inches(0.2), cw, Inches(0.5), size=20)
    b.txt(slide, lbl,  cx+Inches(0.2), cy+Inches(0.8),  cw-Inches(0.4), Inches(0.45), size=12, bold=True)
    b.txt(slide, desc, cx+Inches(0.2), cy+Inches(1.3),  cw-Inches(0.4), Inches(0.65), size=10, color="muted")

b.grid_cards(s, items, Inches(0.8), Inches(3.4), Inches(2.9), Inches(2.1), Inches(0.22), cols=4, draw_fn=draw)
```

**Bullet list with gold dots:**
```python
bullets = ["Item one", "Item two", "Item three"]
for i, text in enumerate(bullets):
    fy = Inches(3.5) + i * Inches(0.55)
    b.oval(s, Inches(0.8), fy + Inches(0.15), Inches(0.12), Inches(0.12), fill="accent")
    b.txt(s, text, Inches(1.1), fy, Inches(5.0), Inches(0.45), size=13)
```

**Gold CTA button:**
```python
b.rect(s, Inches(4.7), Inches(5.1), Inches(3.9), Inches(0.6), fill="accent", border=None)
b.txt(s, "Get Started  →", Inches(4.7), Inches(5.13), Inches(3.9), Inches(0.55),
      size=13, bold=True, color="bg", align=PP_ALIGN.CENTER)
```

© happycapy-ai · MIT · happycapy-ai/Happycapy-skills

Similar skills

All skills for Office documents →

pptx by other authors comes first.

pptx official anthropics Skill for Claude Code creates, parses, and edits .pptx and .potx files. It activates whenever a prompt involves slides, slide decks, or presentation templates. CX Codex +1 241,433installs pptx tfriedel Teaches the agent to create, modify and inspect .pptx files: pull text, dig into slide XML, touch notes and comments. Useful when the deck is generated by code instead of PowerPoint clicks. CX Codex +1 1,700installs pptx appautomaton pptx is a Claude Code skill that creates, edits, and inspects PowerPoint decks from HTML or templates. It can produce reports, adjust XML, or read speaker notes. CX Codex +1 863installs pptx-generator MiniMax-AI pptx-generator — a skill to read, edit, and build PowerPoint decks from scratch using PptxGenJS and XML workflows. Useful when generating presentations from code or extracting slide text. CX Codex +1 6,400installs pptx-visual-assets kimtth pptx-visual-assets places approved icons, images, SVGs, and diagrams onto editable PPTX decks with precise bounding boxes and verified rights. CX Codex +1 2,600installs pptx-reference-deck-analysis kimtth pptx-reference-deck-analysis — a skill for Claude Code, Codex, and Cursor that reads a reference PPTX and pulls out theme, fonts, layout rhythm, and package diagnostics. The source deck stays read-only. CX Codex +1 2,500installs pptx-posters K-Dense-AI pptx-posters is a Claude Code skill that builds and audits editable scientific posters in PowerPoint. It activates for conference or research poster requests. CX Codex +1 2,300installs pptx-generation DNYoussef The pptx-generation skill structures PowerPoint creation around html2pptx, with a design plan before slide generation and checks between sections. It suits reports and larger decks that combine information from several sources. CX Codex +1 4installs image-to-editable-pptx Arinin77 image-to-editable-pptx is a Claude Code skill that reconstructs diagrams, screenshots, and paper figures into editable PowerPoint files. It converts visual elements into native shapes and text. CX Codex +1 ★ 216repo stars

From the same set41

The whole set →
agent-6-docs-writer agent-6-docs-writer is a Claude Code subagent that keeps README files, API docs, code comments, and CHANGELOG entries aligned with code updates in contributor swarms. CX Codex ★ 138repo stars prompt-improver The prompt-improver skill turns underspecified requests into clearer prompts and explains the edits. Use it when you want to adapt a prompt for coding, writing, or image generation. CX Codex +1 ★ 138repo stars agent-5-test-writer agent-5-test-writer writes tests for Agent 4's code changes: picks the repo's framework, adds regression and unit tests, runs the full suite, and records results in ./workspace/test-changes.json. CX Codex ★ 138repo stars mobile-app-developer mobile-app-developer guides Claude Code through scaffolding, previewing, and shipping Expo or React Native apps via EAS cloud builds without needing Xcode or a Mac. CX Codex +1 ★ 138repo stars agent-0-repo-qualifier agent-0-repo-qualifier grades GitHub repositories before issue hunting starts: commit recency, license, maintainer response, CLA blockers. Hands a scored shortlist to the next agent. CX Codex ★ 138repo stars agent-7-pr-creator The agent-7-pr-creator subagent reviews completed changes, prepares commits and a PR description, then opens a pull request with gh. It runs after Agents 4, 5, and 6. CX Codex ★ 138repo stars agent-1-issue-scout agent-1-issue-scout — a Claude subagent that scans pre-qualified GitHub repos for unclaimed good first issues and hands one scored pick to the next agent in the chain. CX Codex ★ 138repo stars html-over-markdown html-over-markdown generates self-contained HTML files with visual layouts, SVG diagrams, and interactive controls instead of plain Markdown. CX Codex +1 ★ 138repo stars

Project sponsors

Companies that keep this analytics open