# slides-generator

Turns a markdown file into a PDF deck: title slide, sections, tables, code and Mermaid diagrams. Handy when you need a talk or technical doc without laying it out by hand.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 371 installs · ★ 32
- Author: hummingbot
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/hummingbot/skills/tree/HEAD/skills/slides-generator/SKILL.md
- Updated: 2026-08-26
- HTML: https://affpapa.org/en/nevibecode/skills/slides-generator

## What it does

The skill reads markdown and builds a PDF deck in Hummingbot branding. A top-level heading becomes the title slide, each `## N. Title` becomes its own slide, and everything under it lands on that slide: lists, bold and italic, code blocks, tables. Before generating, the agent prints the slide outline and waits for your confirmation, so nothing runs twice by accident.

Diagrams start as plain language under `mermaid:` — the agent translates the description into Mermaid code and drops it into the slide. When a slide has both bullets and a diagram, they render in two columns. Diagram rendering needs the Mermaid CLI: `npm install -g @mermaid-js/mermaid-cli`. Without it the chart stays blank while the text still builds, so install the package up front.

Generation runs through `generate_slides.sh`, fetched from GitHub, which checks for Python 3 and the `fpdf2` package. To revise a finished deck, pass `--edit`: the agent reads the source markdown, applies your changes and rebuilds only the slides you touched. The format is strict — markdown that does not follow the `## N. Title` pattern produces an empty PDF.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add hummingbot/skills --skill slides-generator -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/slides-generator/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/slides-generator/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add hummingbot/skills --skill slides-generator -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/slides-generator/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add hummingbot/skills --skill slides-generator -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/slides-generator/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install hummingbot/skills slides-generator
```

2. **Manually: put the files in place**
- File: `.github/skills/slides-generator/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add hummingbot/skills --skill slides-generator -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/hummingbot/skills --path skills/slides-generator
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/slides-generator/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add hummingbot/skills --skill slides-generator -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/hummingbot/skills/tree/HEAD/skills/slides-generator/SKILL.md

## When to use it
- build a PDF deck from a markdown file
- add an architecture diagram to a slide from a text description
- place bullets and a diagram side by side on one slide
- edit individual slides in a finished deck and rebuild it
- turn technical docs into slides with code blocks

## Example prompts
- Build PDF slides from `report.md`, output to `~/report.pdf`
- Add a diagram slide: mermaid: data flow from API to Gateway
- Rebuild the deck with `--edit`, change only slide three

## Similar
- [felo-slides](https://affpapa.org/en/nevibecode/skills/felo-slides.md) — skill · 1000 installs
- [frontend-slides-editable](https://affpapa.org/en/nevibecode/skills/frontend-slides-editable.md) — skill · 536 installs
- [md-slides](https://affpapa.org/en/nevibecode/skills/md-slides.md) — skill · 15 installs
- [paper-slides](https://affpapa.org/en/nevibecode/skills/paper-slides.md) — skill · 520 installs
- [academic-slides](https://affpapa.org/en/nevibecode/skills/academic-slides.md) — skill · 481 installs
- [slides-polish](https://affpapa.org/en/nevibecode/skills/slides-polish.md) — skill · 407 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md