Stats
Links
Categories
agent4ppt
A Claude Code plugin that parses PPTX templates into markdown templates, generates editable PPTX files from markdown, and supports interactive slide revision — all without image-based rendering. Markdown is the single source of truth.
Table of Contents
- Features
- Overview
- Installation
- Quick Start
- Pipeline Architecture
- Skills Reference
- Markdown Format
- Language Support
- Dependencies
- Complete End-to-End Example
- Output Artifact Verification
- Environment Variables
- Contributing
- License
Features
- Template Parsing — Reads a PPTX template and outputs a structured markdown file with placeholder annotations (
<!-- ph:idx type:TYPE -->) - PPTX Generation — Converts markdown back to a PPTX that faithfully reproduces the template's visual layout
- Interactive Revision — 3-step interview workflow to revise specific slides and regenerate PPTX
- Rich Content Support — Tables, charts (bar/pie/line), images, multi-column layouts
- Bilingual Output — Korean (
ko) and English (en) guide comments viaLANGenv variable - 100% Editable — All content is inserted as native python-pptx objects (no image rendering)
Overview
agent4ppt is a Claude Code / OpenClaw plugin that solves a common problem for researchers, engineers, and presenters: maintaining a PPTX slide deck through iterations is tedious and error-prone when the content lives inside binary files.
The Problem
- Editing a PPTX template manually is time-consuming and breaks consistency
- AI-assisted slide generation often relies on screenshot/image pipelines that produce non-editable output
- No reliable way to version-control slide content alongside code or documentation
The Solution: Markdown-First Pipeline
agent4ppt introduces a three-skill pipeline where a human-readable markdown file is the single source of truth for all slide content:
PPTX Template → /parse-ppt-template → Markdown Template
↓ (edit content)
Markdown Content
↓
/generate-ppt → PPTX Output (editable)
/revise-ppt → Interactive revision loop
Key Design Principles
| Principle | Description |
|---|---|
| No image rendering | All PPTX objects are created via python-pptx native API. Output is always fully editable in PowerPoint / LibreOffice Impress. |
| Markdown as truth | Slide content, layout metadata, and revision history all live in a .md file. The PPTX template is referenced only, never modified. |
| Stable placeholder identity | Placeholders are identified by idx (the python-pptx integer index), making round-trips and re-ordering slides safe. |
| Bilingual by design | All user-facing strings (guide comments, prompts, error messages) support Korean and English via the LANG environment variable. |
| Graceful degradation | Optional LibreOffice previews enhance the revision workflow but are never required; the core pipeline runs with Python alone. When a body placeholder is missing from the layout, content is inserted via a textbox fallback (or image fallback for image content). |
Who Is This For?
- Researchers who want to generate slide decks from structured markdown notes
- Engineers who need to automate slide generation in CI/CD or scripted workflows
- Claude Code / OpenClaw users who want a composable skill that integrates naturally with AI-assisted workflows
- Anyone who prefers editing slides as text rather than clicking through PowerPoint