# paper-to-slides

Adopt this skill: https://proskills.md/skills/other/zhangguanghao523-paper-to-slides

Page: https://proskills.md/skills/other/zhangguanghao523-paper-to-slides
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: SKILL.md
size: 5993
upstream: https://github.com/zhangguanghao523/paper-to-slides/blob/HEAD/SKILL.md

````text
---
name: paper-to-slides
description: End-to-end academic paper analysis and presentation generation. Use when a user provides a PDF paper (local path or arXiv URL) and wants (1) a deep research report (dual-mode Part A + Part B), (2) an HTML slide deck for group meeting / seminar / conference talk, or (3) both. Triggers on "read this paper and make slides", "parse this paper into a presentation", "论文研读+做PPT", "解析论文做成slides", or any request combining paper analysis with presentation output. Supports arXiv links (abs/pdf), DOI URLs, and direct PDF URLs.
---

# Paper to Slides

Two-phase pipeline: **Phase 1** deep-reads an academic paper into a structured dual-mode report, **Phase 2** transforms the report into a polished, zero-dependency HTML presentation.

## Dependencies

- `pdftotext` (from poppler) — install via `brew install poppler` or `apt install poppler-utils` if missing
- Google Fonts (loaded via CDN in the generated HTML)

## Phase 1: Paper Deep-Read

### Step 1.0 — Resolve input source

Determine the input type and obtain a local PDF:

| Input | Action |
|-------|--------|
| Local path (`/path/to/paper.pdf`) | Use directly |
| arXiv abs URL (`https://arxiv.org/abs/2603.02096`) | Convert to `https://arxiv.org/pdf/2603.02096` and download |
| arXiv PDF URL (`https://arxiv.org/pdf/2603.02096`) | Download directly |
| Other PDF URL | Download directly |

**Download command:**
```bash
curl -L -o /tmp/paper.pdf "<pdf_url>"
```

Use the arXiv ID or paper title as the filename when possible (e.g., `/tmp/2603.02096_FluxMem.pdf`).

### Step 1.1 — Extract full text

```bash
pdftotext "<paper.pdf>" /tmp/paper_text.txt
```

Read the extracted text completely. For papers with critical figures, try extracting key pages as images via `pdftoppm` and analyzing them with the image tool.

### Step 1.2 — Comprehensive analysis

Create `temp_analysis.md` extracting:

- Research question, hypotheses, methodology, data sources
- Core findings with key quantitative results
- Theoretical contributions and practical implications
- The paper's fundamental contradiction/gap, novel angle, and method innovation

This step is mandatory — it ensures report quality through structured thinking.

### Step 1.3 — Write dual-mode report

Generate `[PaperName]_研读报告.md` containing both parts separated by `---`:

- **Part A** — Read [part-a-template.md](prompts/part-a-template.md) before writing. Deep academic report: structured abstract → introduction → methodology → results → discussion → conclusion → core references.
- **Part B** — Read [part-b-template.md](prompts/part-b-template.md) before writing. Core logic extraction: four key elements table → method formula → one-line summary (expert + layperson versions).

**Writing standards**: Use complete paragraphs over bullet lists. Provide bilingual terms (中英) on first mention. Support every claim with specific data from the paper.

### Step 1.4 — Deliver report

Present the report file and briefly summarize the paper's core innovation, key findings, and theoretical value.

## Phase 2: Slides Generation

If the user only requested a report, stop after Phase 1.

### Step 2.0 — Confirm parameters

Ask the user (all at once):

1. **Purpose**: 组会汇报 / 学术会议 / 教学 / 其他
2. **Length**: Short (5-10) / Medium (10-20) / Long (20+)
3. **Theme**: 亮色 / 暗色 / 偏好的风格
4. **Editing**: 是否需要浏览器内编辑功能

If the user already specified these in the initial request, skip asking and proceed.

### Step 2.1 — Choose style

Select an appropriate style based on user preferences. Read [slide-styles.md](prompts/slide-styles.md) for available presets and CSS specifications. Academic presentations generally suit Swiss Modern (light), Notebook Tabs (light), or Bold Signal (dark).

### Step 2.2 — Plan slide outline

Map the report content to a slide structure. Typical academic paper outline (15-19 slides):

| Section | Slides | Content |
|---------|--------|---------|
| Title | 1 | Paper title, authors, affiliations, date |
| Problem | 1-2 | Background, existing gaps, key insight |
| Method (divider) | 1 | Section divider slide |
| Method details | 3-5 | Core modules, formulas, architecture |
| Results (divider) | 1 | Section divider slide |
| Quantitative results | 2-3 | Main results tables, metrics, comparisons |
| Efficiency / Ablation | 1-2 | Efficiency gains, ablation studies |
| Discussion (divider) | 1 | Section divider slide |
| Advantages & Limitations | 1-2 | Key properties, future directions |
| Summary | 1 | One-line takeaway |
| Thanks | 1 | Links, navigation hints |

### Step 2.3 — Generate HTML

Read [slide-template.md](prompts/slide-template.md) for the mandatory HTML architecture, viewport CSS, JS controller, and inline editing implementation.

**Non-negotiable rules**:
- Single self-contained HTML file, all CSS/JS inline
- Every `.slide` must have `height: 100vh; height: 100dvh; overflow: hidden`
- ALL font sizes and spacing must use `clamp()` — never fixed px/rem
- Load fonts from Google Fonts or Fontshare — never system fonts
- Include `prefers-reduced-motion` support
- Max content per slide: 1 heading + 4-6 bullets OR 1 heading + 2 paragraphs. Overflow → split slides.

**If inline editing is enabled**, implement via `contentEditable` API + `localStorage` persistence. Use JS-based hover with 400ms delay for the edit button (not CSS `~` sibling selector — it breaks due to pointer-events). See the template for the complete implementation.

### Step 2.4 — Open and deliver

```bash
open [filename].html
```

Tell the user: file location, slide count, navigation (arrow keys / space / dots), and editing instructions (press E) if enabled.

## Both Phases Together

When the user requests both report and slides, run Phase 1 fully first, then Phase 2. The report serves as the structured source for slide content — do not re-analyze the paper.
````

## File: README.md
upstream: https://github.com/zhangguanghao523/paper-to-slides/blob/HEAD/README.md

````text
**English** | [中文](README_zh.md)

# Paper to Slides

An AI skill that deep-reads academic papers and turns them into polished HTML presentations — give it a PDF or arXiv link, get back a structured research report and a ready-to-present slide deck.

**Philosophy:** Reading a paper should produce reusable artifacts, not just understanding. A single command gives you both a deep analysis and presentation-ready output.

## What You Get

Give the skill a paper (local PDF, arXiv link, or any PDF URL), and it produces:

- **Research Report** — A dual-mode deep-read: Part A is a full academic analysis (structured abstract → methodology → results → discussion), Part B distills the core logic chain into a one-line summary
- **HTML Slide Deck** — A zero-dependency, animated presentation with 10 style presets, browser-based inline editing, and responsive design that works on any screen

You can request either output alone or both together.

## Quick Start

1. Install the skill in your agent (OpenClaw or Claude Code)
2. Say "read this paper and make slides" with a PDF path or arXiv link
3. The agent handles everything — extraction, analysis, style selection, generation

```
解析 https://arxiv.org/abs/2603.02096，组会汇报，亮色，15页左右
```

```
Deep-read /path/to/paper.pdf, generate report and slides, dark theme
```

The agent will ask about slide preferences (length, theme, editing) if not specified. Or provide them upfront to skip the questions.

## Style Gallery

10 built-in style presets. [Open live preview →](style-preview.html)

### Light Themes

| Swiss Modern ⭐ | Notebook Tabs | Pastel Geometry |
|:---:|:---:|:---:|
| ![Swiss Modern](style-examples/swiss-modern.png) | ![Notebook Tabs](style-examples/notebook-tabs.png) | ![Pastel Geometry](style-examples/pastel-geometry.png) |
| Clean, precise, academic | Editorial, organized, tactile | Friendly, approachable |

| Split Pastel | Vintage Editorial | Paper & Ink |
|:---:|:---:|:---:|
| ![Split Pastel](style-examples/split-pastel.png) | ![Vintage Editorial](style-examples/vintage-editorial.png) | ![Paper & Ink](style-examples/paper-ink.png) |
| Playful, creative, dual-tone | Witty, confident, retro | Literary, thoughtful |

### Dark Themes

| Bold Signal | Neon Cyber | Dark Botanical | Terminal Green |
|:---:|:---:|:---:|:---:|
| ![Bold Signal](style-examples/bold-signal.png) | ![Neon Cyber](style-examples/neon-cyber.png) | ![Dark Botanical](style-examples/dark-botanical.png) | ![Terminal Green](style-examples/terminal-green.png) |
| High-impact, bold | Futuristic, techy | Elegant, artistic | Hacker aesthetic |

## Installation

### OpenClaw

```bash
# From ClawHub (coming soon)
clawhub install paper-to-slides

# Or manually
git clone https://github.com/zhangguanghao523/paper-to-slides.git ~/.openclaw/skills/paper-to-slides
```

### Claude Code

```bash
git clone https://github.com/zhangguanghao523/paper-to-slides.git ~/.claude/skills/paper-to-slides
```

### System Dependency

The skill needs `pdftotext` for PDF text extraction:

```bash
# macOS
brew install poppler

# Ubuntu/Debian
sudo apt install poppler-utils
```

That's it. No Python packages, no npm, no build tools. Generated slides are pure HTML with inline CSS/JS.

## Architecture

This skill uses **progressive disclosure** — the main `SKILL.md` is a concise workflow map, with supporting files loaded on-demand only when needed:

| File | Purpose | Loaded When |
|------|---------|-------------|
| `SKILL.md` | Core two-phase workflow | Always (skill invocation) |
| `prompts/part-a-template.md` | Part A deep academic report template | Phase 1 (report writing) |
| `prompts/part-b-template.md` | Part B core logic extraction template | Phase 1 (report writing) |
| `prompts/slide-styles.md` | 10 curated visual presets | Phase 2 (style selection) |
| `prompts/slide-template.md` | HTML architecture, viewport CSS, JS controller | Phase 2 (generation) |

## Built On

| Component | Role |
|-----------|------|
| [paper-parse](https://clawhub.com) | Dual-mode report templates (Part A + Part B) |
| [frontend-slides](https://github.com/zarazhangrui/frontend-slides) | Zero-dependency HTML presentation framework |
| [poppler](https://poppler.freedesktop.org/) | PDF text & figure extraction (pdftotext / pdftoppm) |

## Requirements

- An AI agent (OpenClaw, Claude Code, or similar)
- `pdftotext` (from poppler) — for PDF text extraction
- Internet connection (for arXiv downloads and Google Fonts in generated slides)

## Credits

Built with [OpenClaw](https://github.com/openclaw/openclaw). Presentation engine adapted from [frontend-slides](https://github.com/zarazhangrui/frontend-slides) by [@zarazhangrui](https://github.com/zarazhangrui). Report templates adapted from [paper-parse](https://clawhub.com).

## License

MIT — Use it, modify it, share it.
````