Turn PPT Master's document-to-editable-PPT workflow into a reusable platform pipeline.
Inspired by hugohe3/ppt-master, this project extracts the core logic behind PPT Master's workflow: read user-provided materials, understand the content, plan the deck, generate pages, and hand off to a real editable PPTX export layer.
English | 中文 | Quickstart
PPT Master is powerful because it can take PDFs, Word documents, URLs, Markdown, pasted text, and images, then produce a real PowerPoint file whose elements can be edited in PowerPoint. Text is text. Shapes are shapes. It is not just exporting slide screenshots.
That is the valuable idea.
This project takes that idea and separates it from one local repo runtime. The goal is to make the PPT production logic easier for agents to implement inside reusable products, such as a website, app, CLI, desktop tool, or internal platform.
It turns the PPT creation process into a clean logic layer:
Analyze -> Strategist -> Image -> Generate -> Output Service
In plain terms:
| Stage | Meaning |
|---|---|
| Analyze | Read and normalize the user's source materials. |
| Strategist | Decide the deck structure, style, page plan, and execution rules. |
| Image | Resolve image needs, prompts, approved assets, placeholders, or rejects. |
| Generate | Produce ordered page artifacts and speaker notes. |
| Output Service | Convert generated artifacts into final deliverables, such as editable PPTX. |
The first four stages are LLM skill stages. Output Service is normal program logic and should not invent new content or redesign the deck.
| Folder | What it contains |
|---|---|
skills/ |
Four PPT production skills split by responsibility. |
skills/_shared/ |
Shared contracts and schemas between stages. |
skills/prompts/ |
Compiled runtime prompts for each stage. |
templates/ |
A normalized template catalog with design specs, preview SVGs, and assets. |
implementation/ |
The protocol for building this pipeline into a real platform. |
Use this project if you want to build a PPT generation product and need a clear agent-facing logic layer instead of a one-off prompt chain.
It is especially useful when you need:
- users to upload or paste source materials
- the system to analyze those materials before designing slides
- generated decks to preserve editable PPT structure
- templates to be reusable across projects
- agent work to be split into reliable stages
- platform code to handle users, storage, model calls, export, and acceptance
This is not a ready-made PPT web app.
It does not include:
- the upstream PPT Master runtime scripts
- a database
- an account system
- model provider defaults
- deployment automation
- a complete PPTX exporter
Those belong in the platform implementation. This repository provides the logic layer, contracts, templates, and implementation guide.
Read QUICKSTART.md if you want to implement the pipeline in a product.
Read implementation/README.md if you are an agent or developer preparing a platform adapter.
This project is inspired by hugohe3/ppt-master. PPT Master focuses on local AI-assisted editable PPTX generation. This project focuses on extracting that workflow into reusable logic and implementation protocols for other platforms.