# slide-maker: editable presentations from your own material
<p align="center">
<a href="README_CN.md"><strong>简体中文</strong></a>
</p>
<p align="center">
<a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg"></a>
<img alt="Codex" src="https://img.shields.io/badge/Codex-supported-111827">
<img alt="Claude Code" src="https://img.shields.io/badge/Claude_Code-supported-5b5bd6">
<img alt="Output: editable PPTX" src="https://img.shields.io/badge/output-native_editable_PPTX-0f766e">
<a href="https://skillhub.cloud.tencent.com/skills/slides-maker"><img alt="Tencent SkillHub" src="https://img.shields.io/badge/Tencent_SkillHub-get_it-2f6feb"></a>
</p>
<p align="center">
<a href="https://clawhub.ai/dong845/skills/slide-maker"><img alt="ClawHub" src="docs/badges/clawhub.svg"></a>
<!-- vl:vl-badge --><a href="https://slides.addsum.top/#languages"><img alt="Templates: 30" src="https://img.shields.io/badge/templates-30-c2410c"></a><!-- /vl -->
</p>
<p align="center"><sub>Free and open source, built by <a href="https://addsum.top/"><strong>Addsum</strong></a></sub></p>
slide-maker is an open-source AI skill for creating editable presentations. It runs in AI assistants that support skills. Give it a paper, repository, document or topic. It plans the content, designs the slides and generates a `.pptx` you can edit in PowerPoint, along with the script used to generate and revise it.
Choose a built-in template or bring a reference deck. Confirm the outline and design before the build, then view the rendered slides and choose the level of independent review.
<p align="center">
<a href="https://slides.addsum.top/#intro"><strong>Intro video</strong></a> ·
<a href="#template-library"><strong>Templates</strong></a> ·
<a href="#example-decks"><strong>Examples</strong></a> ·
<a href="#features-and-deliverables"><strong>Features</strong></a> ·
<a href="#how-it-works"><strong>How it works</strong></a> ·
<a href="#quick-start"><strong>Quick start</strong></a> ·
<a href="#troubleshooting"><strong>Troubleshooting</strong></a>
</p>
## Quick start
Install slide-maker in your AI assistant. Open a terminal, run this command, then choose your assistant and installation scope:
```bash
npx skills add addsumtech/slides_maker
```
After installation, ask your AI assistant to create a presentation. The first run checks the environment and guides you through any missing dependencies. Replace `paper.pdf` in this example with your own filename:
```text
Use slide-maker to turn paper.pdf into an English lab-meeting presentation.
Audience: my advisor and labmates. A 12-minute live talk, about 15 slides.
Keep it visual and concise. Show me the outline and design directions first.
```
To choose a style, browse the templates below and copy its prompt.
## Template library
The skill includes <!-- vl:count-all -->thirty<!-- /vl --> templates. Each has two palettes and seven page types: cover, section, image with text, points, quote, data and closing. Typography, charts and layouts share the same design, with pages adapted to your content.
<!-- vl:count-image-cap -->Four<!-- /vl --> templates use images: **Editorial magazine (editorial), Soft organic (soft) and Collage scrapbook (collage)** arrange your photos; **Watercolour storybook (storybook)** works with a series of illustrations. The other <!-- vl:count-drawn -->twenty-six<!-- /vl --> templates use editable native shapes and need no pictures.
Twelve selected styles are shown below. Select “Preview all pages” beneath a sample to see every page type and both palettes.
<!-- vl:vl-gallery -->
<table>
<tr>
<td align="center" width="33%">
<picture><img src="skills/slide-maker/assets/vl/samples/editorial.jpg" alt="editorial template sample pages"></picture><br/>
<sub><strong>Editorial magazine</strong><br/>Photo layouts<br/>
<a href="https://slides.addsum.top/#vl-editorial">Preview all pages</a></sub>
</td>
<td align="center" width="33%">
<picture><img src="skills/slide-maker/assets/vl/samples/poster.jpg" alt="poster template sample pages"></picture><br/>
<sub><strong>Type poster</strong><br/>launch, manifesto, opinion<br/>
<a href="https://slides.addsum.top/#vl-poster">Preview all pages</a></sub>
</td>
<td align="center" width="33%">
<picture><img src="skills/slide-maker/assets/vl/samples/ink.jpg" alt="ink template sample pages"></picture><br/>
<sub><strong>Ink wash</strong><br/>culture, history, craft<br/>
<a href="https://slides.addsum.top/#vl-ink">Preview all pages</a></sub>
</td>
</tr>
<tr>
<td align="center" width="33%">
<picture><img src="skills/slide-maker/assets/vl/samples/comic.jpg" alt="comic template sample pages"></picture><br/>
<sub><strong>Comic panels</strong><br/>storytelling, user journey, explainer<br/>
<a href="https://slides.addsum.top/#vl-comic">Preview all pages</a></sub>
</td>
<td align="center" width="33%">
<picture><img src="skills/slide-maker/assets/vl/samples/vinyl.jpg" alt="vinyl template sample pages"></picture><br/>
<sub><strong>Vinyl record</strong><br/>music, podcast, culture<br/>
<a href="https://slides.addsum.top/#vl-vinyl">Preview all pages</a></sub>
</td>
<td align="center" width="33%">
<picture><img src="skills/slide-maker/assets/vl/samples/stainedglass.jpg" alt="stainedglass template sample pages"></picture><br/>
<sub><strong>Stained glass</strong><br/>heritage, culture, celebrations<br/>
<a href="https://slides.addsum.top/#vl-stainedglass">Preview all pages</a></sub>
</td>
</tr>
<tr>
<td align="center" width="33%">
<picture><img src="skills/slide-maker/assets/vl/samples/wayfinding.jpg" alt="wayfinding template sample pages"></picture><br/>
<sub><strong>Wayfinding</strong><br/>roadmap, process, onboarding<br/>
<a href="https://slides.addsum.top/#vl-wayfinding">Preview all pages</a></sub>
</td>
<td align="center" width="33%">
<picture><img src="skills/slide-maker/assets/vl/samples/chalkboard.jpg" alt="chalkboard template sample pages"></picture><br/>
<sub><strong>Chalkboard</strong><br/>lesson, class, training<br/>
<a href="https://slides.addsum.top/#vl-chalkboard">Preview all pages</a></sub>
</td>
<td align="center" width="33%">
<picture><img src="skills/slide-maker/assets/vl/samples/recipe.jpg" alt="recipe template sample pages"></picture><br/>
<sub><strong>Recipe card</strong><br/>food, cooking, recipes<br/>
<a href="https://slides.addsum.top/#vl-recipe">Preview all pages</a></sub>
</td>
</tr>
<tr>
<td align="center" width="33%">
<picture><img src="skills/slide-maker/assets/vl/samples/circuit.jpg" alt="circuit template sample pages"></picture><br/>
<sub><strong>Circuit board</strong><br/>hardware, IoT, embedded systems<br/>
<a href="https://slides.addsum.top/#vl-circuit">Preview all pages</a></sub>
</td>
<td align="center" width="33%">
<picture><img src="skills/slide-maker/assets/vl/samples/storybook.jpg" alt="storybook template sample pages"></picture><br/>
<sub><strong>Watercolour storybook</strong><br/>Illustrated storytelling<br/>
<a href="https://slides.addsum.top/#vl-storybook">Preview all pages</a></sub>
</td>
<td align="center" width="33%">
<picture><img src="skills/slide-maker/assets/vl/samples/scoreboard.jpg" alt="scoreboard template sample pages"></picture><br/>
<sub><strong>Scoreboard</strong><br/>sports, competition, team results<br/>
<a href="https://slides.addsum.top/#vl-scoreboard">Preview all pages</a></sub>
</td>
</tr>
</table>
<!-- /vl -->
<p align="center"><a href="https://slides.addsum.top/#languages"><strong>Browse all <!-- vl:count-all -->thirty<!-- /vl --> templates</strong></a></p>
### Using a template
Choose a style in the [online library](https://slides.addsum.top/#languages), copy its prompt and paste it into the AI assistant where you installed slide-maker. Add your material, audience and slide count. For example:
```text
Use slide-maker with the Herbarium (herbarium) template and its light palette.
Turn notes.md into an 8-slide biology lesson for middle-school students.
```
If you are unsure which style to use, ask for recommendations based on your topic. You can also supply a school or company PPTX as a reference for typography, colours and layout.
## Example decks
Twelve finished decks, each built from real material for a common use, in English and in Chinese. The template library sets the look; these show what a complete deck contains: KPI grids, native charts, tables, timelines, diagrams, equations, backup slides and a sources page. Flip through one online, or download its `.pptx` and click into any object. To reuse a deck's design, give its `.pptx` to slide-maker as a reference deck.
<table>
<tr>
<td align="center" width="33%">
<a href="https://slides.addsum.top/viewer.html?deck=en/quarterly-review"><img src="https://slides.addsum.top/docs/assets/screenshots/preview_en_quarterly-review.png" alt="Quarterly Review / Business Update example deck preview"></a><br/>
<sub><strong>Quarterly Review / Business Update</strong><br/>quarterly review, business update, metrics dashboard, exec readout<br/>
<a href="https://slides.addsum.top/viewer.html?deck=en/quarterly-review">Flip online</a> · <a href="https://slides.addsum.top/templates/decks/en/quarterly-review/template.pptx">Download .pptx</a></sub>
</td>
<td align="center" width="33%">
<a href="https://slides.addsum.top/viewer.html?deck=en/chengdu"><img src="https://slides.addsum.top/docs/assets/screenshots/preview_en_chengdu.png" alt="Visual Storytelling / Culture example deck preview"></a><br/>
<sub><strong>Visual Storytelling / Culture</strong><br/>city, culture, event, brand story<br/>
<a href="https://slides.addsum.top/viewer.html?deck=en/chengdu">Flip online</a> · <a href="https://slides.addsum.top/templates/decks/en/chengdu/template.pptx">Download .pptx</a></sub>
</td>
<td align="center" width="33%">
<a href="https://slides.addsum.top/viewer.html?deck=en/transformer-talk"><img src="https://slides.addsum.top/docs/assets/screenshots/preview_en_transformer-talk.png" alt="Lab Meeting / Paper Talk example deck preview"></a><br/>
<sub><strong>Lab Meeting / Paper Talk</strong><br/>paper reading, lab meeting, method overview, experiment report<br/>
<a href="https://slides.addsum.top/viewer.html?deck=en/transformer-talk">Flip online</a> · <a href="https://slides.addsum.top/templates/decks/en/transformer-talk/template.pptx">Download .pptx</a></sub>
</td>
</tr>
<tr>
<td align="center" width="33%">
<a href="https://slides.addsum.top/viewer.html?deck=en/product-launch"><img src="https://slides.addsum.top/docs/assets/screenshots/preview_en_product-launch.png" alt="Product Launch / Keynote example deck preview"></a><br/>
<sub><strong>Product Launch / Keynote</strong><br/>launch keynote, product reveal, spec walkthrough<br/>
<a href="https://slides.addsum.top/viewer.html?deck=en/product-launch">Flip online</a> · <a href="https://slides.addsum.top/templates/decks/en/product-launch/template.pptx">Download .pptx</a></sub>
</td>
<td align="center" width="33%">
<a href="https://slides.addsum.top/viewer.html?deck=en/biology-lesson"><img src="https://slides.addsum.top/docs/assets/screenshots/preview_en_biology-lesson.png" alt="Classroom Lesson / Courseware example deck preview"></a><br/>
<sub><strong>Classroom Lesson / Courseware</strong><br/>school lesson, courseware, in-class quiz, chalkboard look<br/>
<a href="https://slides.addsum.top/viewer.html?deck=en/biology-lesson">Flip online</a> · <a href="https://slides.addsum.top/templates/decks/en/biology-lesson/template.pptx">Download .pptx</a></sub>
</td>
<td align="center" width="33%">
<a href="https://slides.addsum.top/viewer.html?deck=en/pour-over-coffee"><img src="https://slides.addsum.top/docs/assets/screenshots/preview_en_pour-over-coffee.png" alt="Social Carousel / 3:4 Portrait example deck preview"></a><br/>
<sub><strong>Social Carousel / 3:4 Portrait</strong><br/>RedNote or Instagram carousel, how-to post, cheat sheet<br/>
<a href="https://slides.addsum.top/viewer.html?deck=en/pour-over-coffee">Flip online</a> · <a href="https://slides.addsum.top/templates/decks/en/pour-over-coffee/template.pptx">Download .pptx</a></sub>
</td>
</tr>
<tr>
<td align="center" width="33%">
<a href="https://slides.addsum.top/viewer.html?deck=en/startup-pitch"><img src="https://slides.addsum.top/docs/assets/screenshots/preview_en_startup-pitch.png" alt="Startup Pitch / Fundraising example deck preview"></a><br/>
<sub><strong>Startup Pitch / Fundraising</strong><br/>seed pitch, investor meeting, fundraising deck, demo day<br/>
<a href="https://slides.addsum.top/viewer.html?deck=en/startup-pitch">Flip online</a> · <a href="https://slides.addsum.top/templates/decks/en/startup-pitch/template.pptx">Download .pptx</a></sub>
</td>
<td align="center" width="33%">
<a href="https://slides.addsum.top/viewer.html?deck=en/michael-jackson-king-of-pop"><img src="https://slides.addsum.top/docs/assets/screenshots/preview_en_michael-jackson-king-of-pop.png" alt="Biography / Brand Story example deck preview"></a><br/>
<sub><strong>Biography / Brand Story</strong><br/>public figure, brand archive, cultural retrospective<br/>
<a href="https://slides.addsum.top/viewer.html?deck=en/michael-jackson-king-of-pop">Flip online</a> · <a href="https://slides.addsum.top/templates/decks/en/michael-jackson-king-of-pop/template.pptx">Download .pptx</a></sub>
</td>
<td align="center" width="33%">
<a href="https://slides.addsum.top/viewer.html?deck=en/ev-market-report"><img src="https://slides.addsum.top/docs/assets/screenshots/preview_en_ev-market-report.png" alt="Market Report / Newsletter example deck preview"></a><br/>
<sub><strong>Market Report / Newsletter</strong><br/>industry report, periodic briefing, data with a world map<br/>
<a href="https://slides.addsum.top/viewer.html?deck=en/ev-market-report">Flip online</a> · <a href="https://slides.addsum.top/templates/decks/en/ev-market-report/template.pptx">Download .pptx</a></sub>
</td>
</tr>
<tr>
<td align="center" width="33%">
<a href="https://slides.addsum.top/viewer.html?deck=en/corporate-training"><img src="https://slides.addsum.top/docs/assets/screenshots/preview_en_corporate-training.png" alt="Corporate Training / Workshop example deck preview"></a><br/>
<sub><strong>Corporate Training / Workshop</strong><br/>training deck, workshop, skills enablement, exercises<br/>
<a href="https://slides.addsum.top/viewer.html?deck=en/corporate-training">Flip online</a> · <a href="https://slides.addsum.top/templates/decks/en/corporate-training/template.pptx">Download .pptx</a></sub>
</td>
<td align="center" width="33%">
<a href="https://slides.addsum.top/viewer.html?deck=en/thesis-defense"><img src="https://slides.addsum.top/docs/assets/screenshots/preview_en_thesis-defense.png" alt="Thesis Defense / Research Talk example deck preview"></a><br/>
<sub><strong>Thesis Defense / Research Talk</strong><br/>thesis defense, proposal review, academic or engineering talk<br/>
<a href="https://slides.addsum.top/viewer.html?deck=en/thesis-defense">Flip online</a> · <a href="https://slides.addsum.top/templates/decks/en/thesis-defense/template.pptx">Download .pptx</a></sub>
</td>
<td align="center" width="33%">
<a href="https://slides.addsum.top/viewer.html?deck=en/kids-ai-explainer"><img src="https://slides.addsum.top/docs/assets/screenshots/preview_en_kids-ai-explainer.png" alt="Teaching / Knowledge Sharing example deck preview"></a><br/>
<sub><strong>Teaching / Knowledge Sharing</strong><br/>class explanation, reading share, training material<br/>
<a href="https://slides.addsum.top/viewer.html?deck=en/kids-ai-explainer">Flip online</a> · <a href="https://slides.addsum.top/templates/decks/en/kids-ai-explainer/template.pptx">Download .pptx</a></sub>
</td>
</tr>
</table>
<p align="center"><sub>The Chinese versions are in the <a href="README_CN.md#完整示例">Chinese README</a>.</sub></p>
## Features and deliverables
| Feature | What you receive |
| --- | --- |
| Editable PPTX | Text boxes, native shapes and native charts you can change in PowerPoint. Photos, illustrations and cropped paper figures remain images. |
| Equations and data | Editable math text where possible; two-dimensional layouts such as fractions and matrices may be rendered as images. Data charts use native chart objects where suitable, so you can change their values. |
| Notes and animation | Presentation decks include per-slide speaker notes. Click builds are optional; static slides are supported. |
| Previews and build script | PPTX, PDF, browser preview and the generation script. Files go into a subfolder named after the presentation in your Downloads folder by default. The script supports later revisions. |
| Brand and preferences | Extract fonts and colours from brand guidelines, a logo or an existing deck, then confirm and save them for reuse. Recurring design preferences can also be saved. Your current request takes priority. |
| Version history | Keep build versions, compare changes and restore a whole deck or selected slides. |
| Canvas sizes | 16:9, 4:3, 1:1, rednote 3:4 cards, 9:16 portrait and A4, with layouts recomposed for each format. |
Key figures are checked against their sources, and paper figures are cropped from the original where possible. With only a topic, the skill researches it online before planning the slides. Before a formal presentation, confirm that the key data and conclusions match your intent.
## How it works
1. Define the task. Agree on the topic, material, audience, duration, slide count and style. You can delegate design choices; material assumptions are stated before the build.
2. Read the material. Extract text, figures, data and equations, keeping track of sources. Supported inputs include papers, repositories, Word, Excel, CSV, images, audio and video.
3. Confirm the plan. Review the slide-by-slide outline, then the typography, palette, layouts and animation. Without an existing template, you can compare design directions first.
4. Build and check. Generate the PPTX, render its pages and check file structure, overflow, overlaps and fonts.
5. View and review. See the first render, then choose the review tier. Independent reviewers check content and design; revisions are checked before delivery.
6. Revise in conversation. Ask for changes such as “turn slide 7 into a chart,” “make it 10 slides” or “shorten the notes.” The deck is rebuilt from its original script.
### Review and usage
The skill is free. Running it uses your AI subscription or API credits. Slide count, source length, image generation and review effort affect usage and elapsed time.
| `review:` | Scope |
| --- | --- |
| `fast` (default) | One round covering content and design, checking about five key claims. |
| `standard` | Separate content and design reviewers, up to two rounds, checking about ten key claims. |
| `thorough` | A fuller panel with cross-checks where required, up to three rounds, checking all key claims. Suited to defenses, pitches and other high-stakes talks. |
| `none` | Your explicit choice after viewing the render: skip independent review, including its source re-check. |
Long decks are reviewed by section as well as for overall coherence. Delegating the choice runs at least `fast`; it never skips review automatically.
## Installation and setup
Choose either automatic or manual installation. Automatic installation is recommended for most users.
### Automatic installation (recommended)
Run this command in a terminal:
```bash
npx skills add addsumtech/slides_maker
```
Choose your AI assistant and installation scope when prompted. Select a global installation if you want to use the skill across projects. Once installed, ask your assistant to create a presentation.
If `npx` is not found or your Node.js version is too old, install [Node.js](https://nodejs.org/en/download) 22.20 or later, reopen the terminal and try again.
<details>
<summary>More automatic-installation options</summary>
- `-g`: install globally for use across projects.
- `-a claude-code` or `-a codex`: select an assistant without the tool-selection prompt.
- `-y`: skip installation confirmation.
See the [npx skills documentation](https://github.com/vercel-labs/skills) for all options.
</details>
### Manual installation
Use this method if you want a source checkout or prefer to maintain the installation yourself. With Git and Python installed, run these commands in order:
```bash
git clone --depth 1 https://github.com/addsumtech/slides_maker.git
cd slides_maker
python3 -m pip install -r skills/slide-maker/requirements.txt
python3 skills/slide-maker/scripts/install_skill.py --target all
```
The final command copies the skill into the AI-assistant skill directories detected on your machine.
<details>
<summary>Select a manual-installation directory</summary>
`all` detects existing host directories. If none are found, it uses the host-neutral `~/.agents/skills/` directory. To select a directory explicitly, replace `all` with `agents`, `codex` or `claude`.
</details>
<details>
<summary>Claude Code plugin and skill marketplaces</summary>
For plugin installation, enter these commands in Claude Code:
```text
/plugin marketplace add addsumtech/slides_maker
/plugin install slide-maker@slides-maker
```
Other distribution options: [Tencent SkillHub](https://skillhub.cloud.tencent.com/skills/slides-maker) and [ClawHub](https://clawhub.ai/dong845/skills/slide-maker). OpenClaw users can follow the ClawHub installation instructions.
</details>
### Runtime environment
Whichever installation method you choose, the first presentation request checks the environment and attempts to install missing Python packages. If system tools such as Python or LibreOffice are missing, follow the installation instructions shown. Existing tools do not need to be installed again.
You need **Python 3.9+**, **LibreOffice** to render page previews, and librsvg, cairosvg or a Chrome-family browser to rasterize SVG icons. For system tools, use the commands below:
| OS | LibreOffice | SVG icons |
| --- | --- | --- |
| macOS | `brew install --cask libreoffice` | `brew install librsvg` |
| Linux (Ubuntu / Debian) | `sudo apt install libreoffice` | `sudo apt install librsvg2-bin` |
| Windows | `winget install TheDocumentFoundation.LibreOffice` | Install Chrome or Edge |
Windows has less test coverage. If your terminal only provides the `python` command, replace `python3` in the examples with `python`. See [Troubleshooting](#troubleshooting) for other issues.
### Create a presentation
Give your material to the assistant where you installed the skill, or provide a file path it can read, and describe what you need. Claude Code also accepts `/slide-maker`.
In addition to the paper-talk example above, you can start from a repository:
```text
Use slide-maker to introduce this codebase to new teammates.
Focus on the architecture and main workflows.
```
With a reference deck, specify which parts to use:
```text
Use the typography, colours and layouts in /path/ref.pptx as a reference.
Build a new English presentation using the content of paper.pdf.
```
The assistant asks about details that affect the plan, such as audience, slide count and style. Short answers are enough; say “you decide” to delegate a choice.
### Updates and optional images
When a newer version is available, slide-maker asks before updating. It stays quiet when current or offline. Remote version information is cached for 24 hours; local changes are checked each time. To disable version notifications, set `export SLIDE_MAKER_NO_VERSION_CHECK=1`.
Ask for image generation when you need a cover or illustrations. Use the image-generation tool available in your AI assistant, or configure an OpenAI API key. Image generation is optional; native text, shapes and charts do not depend on it.
## Use cases
| Source | Presentation |
| --- | --- |
| Papers, experiment results and figures | Lab meetings, paper readings, conference talks, proposals, defenses, academic posters |
| Repositories, README files, technical docs | Architecture introductions, progress updates, code walkthroughs, engineering reviews |
| Course material, product docs, market data | Lessons, product introductions, market analyses, proposals |
| A topic | A presentation planned from online research |
| A reference PPTX | New content using an existing design as a reference |
| Content for other formats | rednote cards, portrait covers, square cards, A4 one-pagers |
## Troubleshooting
If generation or rendering fails, ask your assistant to locate and run the skill's `scripts/check_env.py`. For a global installation, you can also use the matching directory:
```bash
# Host-neutral skill directory
python3 ~/.agents/skills/slide-maker/scripts/check_env.py
# Codex
python3 ~/.codex/skills/slide-maker/scripts/check_env.py
# Claude Code
python3 ~/.claude/skills/slide-maker/scripts/check_env.py
```
It lists missing dependencies and repair commands.
For build errors, fonts, rendering and image sourcing, see [Troubleshooting & FAQ](skills/slide-maker/references/troubleshooting-faq.md). If the problem persists, open an [issue](https://github.com/addsumtech/slides_maker/issues) with the error output.
## Security and license
See [SECURITY.md](SECURITY.md) for reporting security issues. The project uses the [MIT license](LICENSE).