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.
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 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.
| 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 → build → audit → critique → polish |
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)
- 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)
npx skills add https://github.com/mpuig/agent-slidesThis 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.
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
# 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/slides-extract → /slides-build → /slides-audit → /slides-critique → /slides-polish
↕ ↕
/slides-edit ← (targeted fixes)
Or use /slides-full to run the entire pipeline in one command.
uv sync --all-groups
uv run ruff check .
uv run ty check
uv run pytestMIT. See LICENSE.
Created by Marc Puig
