PPTAgent

A skill that builds presentations from HTML slides with rendering, per-slide visual review, and conversion to an editable PPTX

Skill

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
All reasons and checks

icip-cas/pptagent

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/pptagent

Detects 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 -y

The 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/pptagent

Commands 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 -y

The 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/pptagent

Commands 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 -y

The 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/pptagent

Commands 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 -y

The 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/pptagent

Commands 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 -y

The 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/pptagent

Commands 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/pptagent

Commands 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 -y

The 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/pptagent

Commands 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 -y

The 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/pptagent

Commands 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 -y

The 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/pptagent

Commands 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/pptagent

Commands 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/pptagent

Commands for macOS and Linux, on Windows run them in Git Bash.

You will need: Node.js

Checked against the repository on Sep 25, 2026, commit 833cda5.

Text for your agent

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 delivery

Limitations

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.

Official

Microsoft's utility and MCP server that turn PDF, Word, Excel, PowerPoint, HTML and other files into Markdown for models

MCP serverMedium riskNo VPN needed187.4KRepository stars
Editors’ pick

Anthropic's official skill examples: docx, pdf, pptx and xlsx documents, design, MCP builder and the Agent Skills spec

SkillMedium risk178.8KRepository stars
Editors’ pick

A skill that builds editable PPTX decks from PDF, DOCX, URLs and Markdown with native shapes, charts and animations

SkillMedium risk56.8KRepository stars
Editors’ pick

A skill that draws editorial diagrams as standalone HTML and SVG files: architecture, flowcharts, ER, funnels and about forty more types

SkillMedium riskNo VPN needed42.6KRepository stars
Foxx AIPPTAgent

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.