# paper-slide-deck

Turns articles, notes, and PDF papers into stylized slide images for social sharing and reading. Useful when visual impact matters more than editable text.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 498 installs · ★ 876
- Author: luwill
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/luwill/research-skills/tree/HEAD/paper-slide-deck/SKILL.md
- Updated: 2026-10-25
- HTML: https://affpapa.org/en/nevibecode/skills/paper-slide-deck

## What it does

The skill converts markdown text or PDF documents into image-based slides using Gemini image generation models. It includes 17 visual aesthetics, such as watercolor or sketch-notes. When processing research papers, `detect-figures.ts` identifies figures and tables, while companion scripts crop them into standalone assets. The final slides merge into `.pptx` and `.pdf` files.

Operation relies on TypeScript and Python scripts located in `scripts/`. Running `npm install` inside that directory sets up `canvas`, `pdfjs-dist`, `pptxgenjs`, and `pdf-lib`. You must also install Python packages via `pip install pymupdf` for extracting embedded bitmaps and `pip install Pillow` to convert Gemini WebP outputs to PNG format.

This workflow fails on formal thesis talks because image models distort equations and exact numbers. When running without a Gemini API key, passing `--outline-only` keeps the pipeline working by producing outline markdown and image prompts while skipping generation.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add luwill/research-skills --skill paper-slide-deck -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add luwill/research-skills --skill paper-slide-deck -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add luwill/research-skills --skill paper-slide-deck -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install luwill/research-skills paper-slide-deck
```

2. **Manually: put the files in place**
- File: `.github/skills/paper-slide-deck/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add luwill/research-skills --skill paper-slide-deck -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/luwill/research-skills --path paper-slide-deck
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add luwill/research-skills --skill paper-slide-deck -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/luwill/research-skills/tree/HEAD/paper-slide-deck/SKILL.md

## When to use it
- Turn markdown articles or PDF papers into stylized slide decks
- Extract existing figures and tables directly from academic PDF files
- Produce reading-oriented visual decks in 17 distinct visual styles
- Build presentation outlines and image generation prompts without an API key

## Example prompts
- /paper-slide-deck paper.pdf --style sketch-notes
- /paper-slide-deck article.md --audience executives --slides 10
- /paper-slide-deck paper.pdf --outline-only

## Similar
- [baoyu-slide-deck](https://affpapa.org/en/nevibecode/skills/baoyu-slide-deck.md) — skill · 31200 installs
- [slide-maker](https://affpapa.org/en/nevibecode/skills/slide-maker.md) — skill · 1200 installs
- [pptx-deck-context](https://affpapa.org/en/nevibecode/skills/pptx-deck-context.md) — skill · 2500 installs
- [utility-slideshow-creator](https://affpapa.org/en/nevibecode/skills/utility-slideshow-creator.md) — skill · 719 installs
- [paper-slides](https://affpapa.org/en/nevibecode/skills/paper-slides.md) — skill · 520 installs
- [pptx-slide-specification](https://affpapa.org/en/nevibecode/skills/pptx-slide-specification.md) — skill · 2600 installs

From the same set: [luwill/research-skills](https://affpapa.org/en/nevibecode/by/luwill/research-skills.md) — 2 cards

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