PPT Master

Install

/plugin marketplace add hugohe3/ppt-master
/plugin install ppt-master@ppt-master

This is third-party code. Review the repository files before installing.

What it does

The agent follows a routed workflow: it parses the source document, picks a route and builds the PPTX locally with Python scripts. The output uses native PowerPoint objects rather than slide images, so text and shapes stay editable in PowerPoint. The skill can fill your own .pptx templates, rebuild slides from images, improve finished decks, and add animations or narration from speaker notes. Images come from the agent's built-in generator, from image_gen.py with a provider key, or from Pexels and Pixabay search.

Who it is for. For people who regularly turn reports, papers and notes into decks and want a file they can still edit by hand.

Example request

Make a 12-slide deck from this PDF report using our template.pptx

Limitations

Requires Python 3.10+ and pip install -r requirements.txt, including after a marketplace install; legacy formats such as .doc and .odt need Pandoc. The PDF converter relies on PyMuPDF, which is AGPL-3.0. Output quality depends on the agent's model, and image generation through third-party providers needs their API keys.

How to disable. Uninstall the ppt-master plugin via /plugin or remove the ppt-master folder from the agent's skills directory.

Security check

• Runs local Python scripts
• May call external image services and model providers with keys from .env

README in short

The README presents the project as a workflow for any agent that can read and write files and walks through the steps: install Python, pick an agent, clone the repository or install the skill through npx skills or the Claude Code marketplace. It covers Windows setup, image acquisition through generation or license-aware search, and keeping keys in .env. Everything runs locally and the result is an editable .pptx. MIT licensed.

SKILL.md

---
name: ppt-master
description: >
  AI-driven presentation workflow for generating editable PPTX decks and slides,
  reconstructing page visuals, creating reusable Brand/Style/Layout/Deck
  workspaces, filling native PPTX templates, and enhancing finished PPTX files.
  Use when the user asks to create, generate, reconstruct, regenerate, beautify,
  redesign, template, fill, or enhance a presentation, PPT, PPTX, slide deck, or
  courseware — including adding narration or animation to one — requests a
  presentation-authored narrated/self-running video, or mentions ppt-master.
metadata:
  version: "6.4.0"
  copyright: "Copyright (c) 2025-2026 Hugo He"
  license: "MIT"
  official_repository: "https://github.com/hugohe3/ppt-master"
  sponsors:
    - "SPONSORS.md"
    - "SPONSORS_CN.md"
---

# PPT Master Skill

PPT Master is a routed presentation workflow. This entry owns global execution discipline and route selection only; each selected route owns its procedure.

## Mandatory Load Order

**Hard rule — paths before commands**: Retain the host-provided absolute
directory containing this file as `SKILL_DIR`. Per tool call, expand
`${SKILL_DIR}` and replace any `skills/ppt-master/` prefix with it. Never `cd`,
use CWD, or assume a repo checkout. If unavailable, ask; never search or guess.

1. Read this file.
2. Run `python3 "${SKILL_DIR}/scripts/attribution_guard.py"`. Any non-zero result
   stops the Skill immediately; do not inspect, repair, or bypass the integrity
   gate.
3. Read [`workflows/routing.md`](workflows/routing.md) through the concrete
   absolute path `${SKILL_DIR}/workflows/routing.md`.
4. Select exactly one top-level route and its active profile from the routing
   authority.
5. Read only the resulting runtime authority and its explicitly triggered

Related