# kimi-pdf

A skill that turns HTML into PDF with Paged.js, compiles LaTeX, and works with existing files: extract text, merge, split, fill forms.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 419 installs · ★ 240
- Author: thvroyal
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/thvroyal/kimi-skills/tree/HEAD/skills/kimi-pdf/SKILL.md
- Updated: 2026-03-28
- HTML: https://affpapa.org/en/nevibecode/skills/kimi-pdf

## What it does

The skill picks one of three routes based on what you ask. Plain requests like a report or a paper go to HTML, which is the default. Say LaTeX, `.tex` or Tectonic and you get the LaTeX route. Existing PDFs go through the process route: reading, extracting, merging, splitting, filling forms.

The HTML route covers KaTeX formulas, Mermaid diagrams, three-line tables and citations. Citation style follows the document language: GB/T 7714 for Chinese, APA for English, and in a mixed document each reference list gets its own format. Cross-references to figures, equations and sections are clickable through a container `id`.

Before writing any code the skill insists you read the route file, because the implementation details live there rather than in the main description. Dependencies differ per route: HTML needs Node.js, Playwright and Chromium, PDF processing needs Python 3 with pikepdf and pdfplumber, LaTeX needs Tectonic. Run `pdf.sh check` to see what is missing, then `pdf.sh fix` to install it.

## Requirements
- Works with: Playwright

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add thvroyal/kimi-skills --skill kimi-pdf -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add thvroyal/kimi-skills --skill kimi-pdf -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add thvroyal/kimi-skills --skill kimi-pdf -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install thvroyal/kimi-skills kimi-pdf
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add thvroyal/kimi-skills --skill kimi-pdf -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/thvroyal/kimi-skills --path skills/kimi-pdf
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add thvroyal/kimi-skills --skill kimi-pdf -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/thvroyal/kimi-skills/tree/HEAD/skills/kimi-pdf/SKILL.md

## When to use it
- build a PDF paper or report from HTML
- add KaTeX formulas and Mermaid diagrams to a document
- format citations in GB/T 7714 or APA style
- pull text out of an existing PDF
- merge or split several PDF files

## Example prompts
- turn this text into a PDF report with a cover page
- build a paper PDF with KaTeX formulas and an APA reference list
- extract the text from `report.pdf` and merge it with `appendix.pdf`

## Similar
- [presentation-generator](https://affpapa.org/en/nevibecode/skills/presentation-generator.md) — skill · 320 installs
- [pdf-generation](https://affpapa.org/en/nevibecode/skills/pdf-generation.md) — skill · 482 installs
- [slide-creator](https://affpapa.org/en/nevibecode/skills/slide-creator.md) — skill · 4100 installs
- [pdf-to-html](https://affpapa.org/en/nevibecode/skills/pdf-to-html.md) — skill · 458 installs
- [eyeball](https://affpapa.org/en/nevibecode/skills/eyeball.md) — skill · 68 installs
- [pdf-to-docx](https://affpapa.org/en/nevibecode/skills/pdf-to-docx.md) — skill · 6000 installs

From the same set: [thvroyal/kimi-skills](https://affpapa.org/en/nevibecode/by/thvroyal/kimi-skills.md) — 3 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