# paper2html

paper2html converts academic papers from arXiv, LaTeX or PDF into self-contained Chinese reading pages with KaTeX math and verified evidence.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 475 repo stars
- Author: cnfjlhj
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cnfjlhj/ai-collab-playbook/tree/HEAD/skills/full/paper2html/SKILL.md
- Updated: 2026-10-13
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/paper2html

## What it does

This workflow converts academic papers into standalone HTML documents designed for thorough reading without reopening original files. It handles arXiv identifiers, OpenReview entries, local TeX packages, and standard PDF documents. The process relies on dedicated helper scripts rather than pure prompt generation.

Execution starts with `bootstrap_paper2html.py` creating the workspace and documentation notes. If TeX sources exist, `tex_inventory.py` catalogs equations and notations. Meanwhile, `optimize_paper_images.py` rescales extracted figures and packages them directly into data URI strings, ensuring the finished page functions independently of external image hosting.

The resulting page follows a defined narrative structure: summary, method flow, experimental evidence, bounded takeaways, and review viewpoints. Local paths remain excluded from output pages to prevent accidental private data leaks when publishing.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add cnfjlhj/ai-collab-playbook --skill paper2html -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add cnfjlhj/ai-collab-playbook --skill paper2html -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add cnfjlhj/ai-collab-playbook --skill paper2html -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install cnfjlhj/ai-collab-playbook skills/full/paper2html
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add cnfjlhj/ai-collab-playbook --skill paper2html -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/cnfjlhj/ai-collab-playbook --path skills/full/paper2html
```

### Windsurf (Devin Desktop)

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

### 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/cnfjlhj/ai-collab-playbook/tree/HEAD/skills/full/paper2html/SKILL.md

## When to use it
- turn arXiv papers into self-contained HTML reading sheets
- bundle TeX formulas and figures into single-file documents
- extract experimental reproducibility details from LaTeX sources
- generate structured review analyses across multiple evaluation roles

## Example prompts
- Process paper 2504.07952 from arXiv into an index.html sheet using paper2html
- Analyze unpacked TeX sources and package all figures with data URIs
- Validate the generated research HTML file before shipping it

## Similar
- [autoresearchclaw-autonomous-research](https://affpapa.org/en/nevibecode/skills/autoresearchclaw-autonomous-research.md) — skill · 1600 installs
- [yomitoki](https://affpapa.org/en/nevibecode/skills/yomitoki.md) — skill · ★ 240 repo stars
- [read-arxiv-paper](https://affpapa.org/en/nevibecode/skills/read-arxiv-paper.md) — skill · 2900 installs
- [paper-writing](https://affpapa.org/en/nevibecode/skills/paper-writing.md) — skill · 619 installs
- [paper-version](https://affpapa.org/en/nevibecode/skills/paper-version.md) — skill · ★ 579 repo stars
- [academic-slides](https://affpapa.org/en/nevibecode/skills/franklee16-academic-slides.md) — skill · ★ 240 repo stars

From the same set: [cnfjlhj/ai-collab-playbook](https://affpapa.org/en/nevibecode/by/cnfjlhj/ai-collab-playbook.md) — 18 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
