agent-slides
Agent skill for generating professional PowerPoint decks. 7 composable skills, a purpose-built CLI, and a Python API.
Quick start: Visit agent-slides.com for docs, examples, and getting started guides.
Why agent-slides?
Every AI agent can write text, but generating a polished, brand-compliant PowerPoint deck requires workflow knowledge that doesn't fit in a system prompt: when to preflight a project, when to dry-run, how to chain extraction → build → QA stages, how to recover from validation errors.
agent-slides encodes that knowledge in 7 composable skills, backed by a CLI that speaks JSON and a Python API that wraps python-pptx into a deterministic, agent-safe layer.
What's Included
7 Skills
| Skill | Command | What it does |
|---|
| slides-extract | /slides-extract | Extract template contracts from a .pptx file |
| slides-build | /slides-build | Build a complete deck from a brief |
| slides-edit | /slides-edit | Text edits, layout transforms, ops patches |
| slides-audit | /slides-audit | Technical lint: fonts, overlap, contrast |
| slides-critique | /slides-critique | Storytelling: action titles, MECE, hierarchy |
| slides-polish | /slides-polish | Final pass: notes, metadata, sources |
| slides-full | /slides-full | End-to-end: extract → preflight → build → audit → critique → polish |
The CLI
Skills call uvx --from agent-slides slides ... under the hood. The CLI provides:
- Declarative JSON operations with dry-run and transactional rollback
- Template extraction (layouts, archetypes, color zones, icons)
- Project preflight checks for extracted contracts, profile paths, icon packs, asset roots, and optional deps
- Validation, linting, and QA with design profiles
- Agent-optimized output (compact JSON, pagination, field masking)
- Runtime schema discovery (
uvx --from agent-slides slides docs json)
Installation
npx skills add https://github.com/mpuig/agent-slides
This installs the skills for Claude Code, Cursor, Gemini CLI, or Codex CLI — your choice. Skills call uvx --from agent-slides slides ... under the hood, so make sure uv is available in your environment.
Usage
Once installed, use skills in your agent harness:
/slides-extract template.pptx # Extract template contracts
/slides-build # Build deck from a brief
/slides-audit # Check for technical issues
/slides-full # Run the full pipeline
Or use the CLI directly:
# Render a deck from a slides document
uvx --from agent-slides slides render --slides-json @slides.json --profile design-profile.json --output out.pptx
# Extract template contracts
uvx --from agent-slides slides extract template.pptx --output-dir extracted
# Preflight the extracted project before render
uvx --from agent-slides slides preflight --project-dir extracted --profile extracted/design-profile.json
# Validate and lint
uvx --from agent-slides slides validate out.pptx
uvx --from agent-slides slides lint out.pptx --profile design-profile.json --out lint.json
# Inspect and search
uvx --from agent-slides slides inspect out.pptx --summary
uvx --from agent-slides slides find out.pptx --query "pricing" --out results.json
# Schema discovery
uvx --from agent-slides slides docs json
uvx --from agent-slides slides docs schema:slides-document
Typical Workflow
/slides-extract → preflight → /slides-build → /slides-audit → /slides-critique → /slides-polish
↕ ↕ ↕
/slides-edit targeted fixes targeted fixes
Or use /slides-full to run the entire pipeline in one command.
Development
uv sync --all-groups
uv run ruff check .
uv run ty check
uv run pytest
License
MIT. See LICENSE.
Created by Marc Puig
mpuig