PPTAgent
A skill that builds presentations from HTML slides with rendering, per-slide visual review, and conversion to an editable PPTX
Medium risk
We rate an entry medium when the tool runs code, makes network calls or reads project files. Check what exactly it does before installing.
Why this level
- Runs Python rendering and build scripts on your machine with access to the working directory
Install
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/pptagentDetects the agents on your machine, checks the risk and pins the version.
Other ways to install
Run in a terminal in the project folder
npx skills add icip-cas/pptagent --skill pptagent -a claude-code -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 833cda5
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/icip-cas/pptagent.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/pptagent/
git -C "$tmp" checkout 833cda553b343be0e486a93b0b57cac962cdd566
mkdir -p .claude/skills
cp -R "$tmp/skills/pptagent" .claude/skills/pptagentCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add icip-cas/pptagent --skill pptagent -a cursor -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 833cda5
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/icip-cas/pptagent.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/pptagent/
git -C "$tmp" checkout 833cda553b343be0e486a93b0b57cac962cdd566
mkdir -p .agents/skills
cp -R "$tmp/skills/pptagent" .agents/skills/pptagentCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add icip-cas/pptagent --skill pptagent -a github-copilot -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 833cda5
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/icip-cas/pptagent.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/pptagent/
git -C "$tmp" checkout 833cda553b343be0e486a93b0b57cac962cdd566
mkdir -p .github/skills
cp -R "$tmp/skills/pptagent" .github/skills/pptagentCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add icip-cas/pptagent --skill pptagent -a codex -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 833cda5
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/icip-cas/pptagent.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/pptagent/
git -C "$tmp" checkout 833cda553b343be0e486a93b0b57cac962cdd566
mkdir -p .agents/skills
cp -R "$tmp/skills/pptagent" .agents/skills/pptagentCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add icip-cas/pptagent --skill pptagent -a gemini-cli -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 833cda5
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/icip-cas/pptagent.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/pptagent/
git -C "$tmp" checkout 833cda553b343be0e486a93b0b57cac962cdd566
mkdir -p .agents/skills
cp -R "$tmp/skills/pptagent" .agents/skills/pptagentCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/icip-cas/pptagent.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/pptagent/
git -C "$tmp" checkout 833cda553b343be0e486a93b0b57cac962cdd566
mkdir -p .devin/skills
cp -R "$tmp/skills/pptagent" .devin/skills/pptagentCommands for macOS and Linux, on Windows run them in Git Bash.
Formerly Windsurf.
Run in a terminal in the project folder
npx skills add icip-cas/pptagent --skill pptagent -a cline -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 833cda5
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/icip-cas/pptagent.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/pptagent/
git -C "$tmp" checkout 833cda553b343be0e486a93b0b57cac962cdd566
mkdir -p .cline/skills
cp -R "$tmp/skills/pptagent" .cline/skills/pptagentCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add icip-cas/pptagent --skill pptagent -a roo -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 833cda5
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/icip-cas/pptagent.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/pptagent/
git -C "$tmp" checkout 833cda553b343be0e486a93b0b57cac962cdd566
mkdir -p .roo/skills
cp -R "$tmp/skills/pptagent" .roo/skills/pptagentCommands for macOS and Linux, on Windows run them in Git Bash.
A fork of Roo Code, same .roo folders.
Run in a terminal in the project folder
npx skills add icip-cas/pptagent --skill pptagent -a opencode -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 833cda5
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/icip-cas/pptagent.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/pptagent/
git -C "$tmp" checkout 833cda553b343be0e486a93b0b57cac962cdd566
mkdir -p .agents/skills
cp -R "$tmp/skills/pptagent" .agents/skills/pptagentCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/icip-cas/pptagent.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/pptagent/
git -C "$tmp" checkout 833cda553b343be0e486a93b0b57cac962cdd566
mkdir -p .agents/skills
cp -R "$tmp/skills/pptagent" .agents/skills/pptagentCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/icip-cas/pptagent.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/pptagent/
git -C "$tmp" checkout 833cda553b343be0e486a93b0b57cac962cdd566
mkdir -p .agents/skills
cp -R "$tmp/skills/pptagent" .agents/skills/pptagentCommands for macOS and Linux, on Windows run them in Git Bash.
Copy skills/pptagent into your agent's skills directory, install dependencies into a venv, then run: python scripts/pptagent.py doctor --workspace "$PWD" to check the environment before first use.
This is third-party code. Review the repository files before installing.
What it does
PPTAgent walks an agent through the full deck-building cycle: init with slide count, aspect ratio and language, authoring slides in HTML, rendering and recording a verdict per slide via record-slide-review, then building the deck and a final review of the whole thing with contact sheets. The skill itself does not write the slide text for the agent; it provides a CLI for rendering, converting to an editable PPTX, and verifying that the final file matches the approved sources. The final answer.pptx is only delivered once every check is marked complete, or explicitly as a draft with unresolved issues disclosed.
Who it is for. For anyone who needs more than a generated slide image, a genuinely editable PPTX with quality review of every slide.
Good fit when
- You need a PPTX presentation you can later edit in PowerPoint
- Every slide needs a visual check for clipped text, overlaps and broken images before delivery
- You need a specific shape: a fixed slide count, aspect ratio, language
Not a fit when
- A static image or PDF with no editing needed is enough
- You need a presentation with advanced animation, not just static slides
Example request
Build an 8-slide 16:9 presentation about the quarter's results in English and review every slide before deliveryLimitations
Needs a configured Python 3.11+ environment with the skill's dependencies, and the review_slides and review_deck MCP tools for the text-only mode without image viewing. The default multimodal mode relies on the host agent's built-in image viewer.
How to disable. Remove the skills/pptagent folder from your agent's skills directory.
Security check
- Runs Python rendering and build scripts on your machine with access to the working directory
README in short
The project presents itself as a research framework for reflective presentation generation (an arXiv paper), but the repository ships a ready-to-install skill at skills/pptagent with a SKILL.md, scripts and tests. The skill documents the full cycle: workspace init, authoring slides in HTML, rendering, recording a verdict per slide, building the deck, a final contact-sheet review, and finalize, which delivers answer.pptx only once every check passes. MIT licensed.
SKILL.md
--- name: pptagent description: Create and revise editable PowerPoint presentations from a brief using HTML slide sources, rendering, and visual review. Use when the requested deliverable is a PPTX deck. The host authors the slides; text-only hosts can use an external visual reviewer. --- # 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.
FAQ
Can the final file be edited in PowerPoint?
Yes, the skill converts the built HTML slides into an editable PPTX rather than just exporting images.
What if some slides fail review?
The final file is only delivered when complete=true, or the user explicitly accepts a draft with disclosed open issues via delivery.mode: best-effort.
Related
Microsoft's utility and MCP server that turn PDF, Word, Excel, PowerPoint, HTML and other files into Markdown for models
Anthropic skills
Skills
Anthropic's official skill examples: docx, pdf, pptx and xlsx documents, design, MCP builder and the Agent Skills spec
A skill that builds editable PPTX decks from PDF, DOCX, URLs and Markdown with native shapes, charts and animations
A skill that draws editorial diagrams as standalone HTML and SVG files: architecture, flowcharts, ER, funnels and about forty more types