PPTAgent
Use the host agent to research and author slides. The CLI handles rendering, editable conversion, and verification that the delivered PPTX matches the reviewed sources. Do not start another authoring agent.
Setup
Resolve SKILL_ROOT to this directory. Use its .venv/bin/python when present,
otherwise an activated Python 3.11+ environment with the dependencies installed.
Set SKILL_PYTHON to that interpreter and run:
"$SKILL_PYTHON" "$SKILL_ROOT/scripts/pptagent.py" doctor --workspace "$PWD"
Read references/task-contract.md for file layout
and HTML conversion constraints. The default mode: multimodal uses the host's
image viewer. Only for mode: text, read references/text.md.
When review_slides and review_deck MCP tools are available in text mode, use
them for the corresponding review steps. Configuration is optional; defaults
live in config.example.yaml.
Create or revise
- Resolve the user's audience, message, page count, language, and aspect ratio.
For a new workspace, run
init --workspace "$PWD" --slides N, with optional--aspect-ratio 16:9|4:3|A1and--language. Existing tasks usetask.json. - Use available research tools as needed and preserve sources for checkable claims. A manuscript or asset manifest is useful for complex decks, not a prerequisite for every edit.
- Use
scaffoldif starter HTML is useful; it preserves existing slides. Author exactly the requested page count and replace the starter text. - Run
review-slides, inspect every returned image, then record each result:
"$SKILL_PYTHON" "$SKILL_ROOT/scripts/pptagent.py" record-slide-review --workspace "$PWD" --slide slides/slide01.html --verdict pass --summary "Readable; no clipping, overlap, or broken images."
- Run
build, thenreview-deck. Inspect the exported deck's contact sheets; open full-size pages for dense content. Recordrecord-deck-reviewwith--verdictand--summary. Text mode records visual results automatically. - Fix issues that affect the user's requirements or visible quality. Source changes require fresh renders, reviews, and a build. Shared resource changes invalidate all slide reviews. Rendering alone does not establish a pass.
- Run
finalize. Deliveranswer.pptxonly whencomplete=true. If the user explicitly accepts an incomplete draft, setdelivery.mode: best-effort;delivery_ready=truethen permits delivery with the failed checks disclosed.
Commands take --workspace with an absolute path and emit JSON. Use --help
for arguments. A successful delivery includes a current final-report.json.
Keep API keys in environment variables or the skill's .env, outside artifacts.