# pdf-tools

Скилл pdf-tools для Claude Code, Codex, Cursor, GitHub Copilot и Gemini CLI, который покрывает весь цикл работы с PDF: извлечение текста и таблиц, генерацию, изменение и заполнение форм.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 186 установок · ★ 29 у репозитория
- Автор: oakoss
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/oakoss/agent-skills/tree/HEAD/skills/pdf-tools/SKILL.md
- Обновлён: 2026-08-17
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/pdf-tools

## Что делает

Скилл задаёт агенту чёткую карту инструментов: Puppeteer и Playwright — для генерации PDF из HTML, `pdf-lib` и форк `@cantoo/pdf-lib` — для правки, слияния и работы с AcroForm-полями, `unpdf` — для лёгкого извлечения текста на edge и serverless, `pdfplumber` на Python — для таблиц со сложной разметкой. Шифрование через `qpdf` с AES-256, цифровые подписи через `@signpdf/*` с PKCS#7 и P12-сертификатами.

Скилл различает сценарии, где стандартные парсеры не справятся. Для многоколоночного текста и слитых ячеек он направляет агента к vision-модели с Zod-схемой или к `pdfplumber`. Для незаполнимых форм — к Python-скриптам с аннотациями по bounding box. Для архивного соответствия PDF/A — к `ghostscript` и `verapdf`. Есть отдельный раздел про очереди на BullMQ с Redis.

В скилле прямо описаны типичные ошибки: `window.print()` на сервере, запуск Puppeteer в edge-окружении, запись в поля сплющенной формы без инспекции AcroForm. Если нужна редакция с удалением байтов, а не визуальным перекрытием, скилл указывает на `pymupdf` с `apply_redactions()` — стандартный overlay контент не удаляет.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add oakoss/agent-skills --skill pdf-tools -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/pdf-tools/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/pdf-tools/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add oakoss/agent-skills --skill pdf-tools -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/pdf-tools/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add oakoss/agent-skills --skill pdf-tools -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/pdf-tools/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install oakoss/agent-skills skills/pdf-tools
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/pdf-tools/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add oakoss/agent-skills --skill pdf-tools -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/oakoss/agent-skills --path skills/pdf-tools
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/pdf-tools/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add oakoss/agent-skills --skill pdf-tools -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/oakoss/agent-skills/tree/HEAD/skills/pdf-tools/SKILL.md

## Когда брать
- извлечь таблицы с объединёнными ячейками из PDF через vision-модель
- сгенерировать PDF из HTML-шаблона на React с точным воспроизведением верстки
- заполнить незаполнимую PDF-форму через аннотации по координатам
- зашифровать PDF с AES-256 перед сохранением в хранилище
- настроить пакетную очередь обработки PDF с повторами и отслеживанием прогресса

## Примеры запросов агенту
- Извлеки таблицу из `report.pdf` через vision-модель и верни структуру по Zod-схеме
- Сгенерируй PDF из `invoice.html` через Puppeteer и встрой шрифты из WOFF2
- Зашифруй `contract.pdf` с AES-256 через `qpdf` и задай пароль пользователя и владельца

## Похожие
- [pdf-to-markdown](https://affpapa.org/nevibecode/skills/lttr-pdf-to-markdown.md) — скилл · 5 установок
- [pdf-toolkit-mcp](https://affpapa.org/nevibecode/mcp/pdf-toolkit-mcp.md) — MCP-сервер · ★ 12 у репозитория
- [pdf-generator](https://affpapa.org/nevibecode/skills/pdf-generator.md) — скилл · 927 установок
- [html-to-pdf](https://affpapa.org/nevibecode/skills/html-to-pdf.md) — скилл · 1300 установок
- [document-generation-pdf](https://affpapa.org/nevibecode/skills/document-generation-pdf.md) — скилл · 283 установки
- [pdf](https://affpapa.org/nevibecode/skills/nexu-io-pdf.md) — скилл · 3200 установок

Из того же набора: [oakoss/agent-skills](https://affpapa.org/nevibecode/by/oakoss/agent-skills.md) — 106 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
