This release is a pre-release and may not be stable for production use.
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 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 → build → audit → critique → polish |
The CLI
Skills call uvx --from git+https://github.com/mpuig/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 git+https://github.com/mpuig/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 git+https://github.com/mpuig/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 git+https://github.com/mpuig/agent-slides slides render --slides-json @slides.json --profile design-profile.json --output out.pptx
# Extract template contracts
uvx --from git+https://github.com/mpuig/agent-slides slides extract template.pptx --output-dir extracted
# Validate and lint
uvx --from git+https://github.com/mpuig/agent-slides slides validate out.pptx
uvx --from git+https://github.com/mpuig/agent-slides slides lint out.pptx --profile design-profile.json --out lint.json
# Inspect and search
uvx --from git+https://github.com/mpuig/agent-slides slides inspect out.pptx --summary
uvx --from git+https://github.com/mpuig/agent-slides slides find out.pptx --query "pricing" --out results.json
# Schema discovery
uvx --from git+https://github.com/mpuig/agent-slides slides docs json
uvx --from git+https://github.com/mpuig/agent-slides slides docs schema:slides-document
Typical Workflow
/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.
Development
uv sync --all-groups
uv run ruff check .
uv run ty check
uv run pytest
License
MIT. See LICENSE.
Created by Marc Puig
Metadata
Release files for agent-slides 0.1.0a0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| agent_slides-0.1.0a0.tar.gz | 31.8 MB | Without provenance | Details for agent_slides-0.1.0a0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| agent_slides-0.1.0a0-py3-none-any.whl | Python 3 | none | any | Details for agent_slides-0.1.0a0-py3-none-any.whl |
Total release size: 31.9 MB
Release files / agent_slides-0.1.0a0.tar.gz
| Download URL | agent_slides-0.1.0a0.tar.gz |
|---|---|
| Size | 31.8 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9cd102c8ca6f3fdb28387ea91b418fdac157ac332029b78e875ef94420593f16
|
|
BLAKE2b-256 checksum How to use checksums |
85a6a8a82167d17e910cc5a9dd3b14ea4762bad98cddc6abaee1b027acccf2b8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / agent_slides-0.1.0a0-py3-none-any.whl
| Download URL | agent_slides-0.1.0a0-py3-none-any.whl |
|---|---|
| Size | 98.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
594d36048e986f9fa403039f9f3e714b457da030d46e2d55fb0635e650a12da7
|
|
BLAKE2b-256 checksum How to use checksums |
48528991329853a5be29e8b8e0f96506a7cacdada8ebf44bfc12da26feb8d551
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for agent-slides 0.1.0a0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.