К основному содержанию
скилл CX Codex

pdf-tools — скилл для Claude Code, Codex и Cursor: работа с PDF

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

MIT 186 установок ★ 29 обновлён 2026-08-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add oakoss/agent-skills --skill pdf-tools -a claude-code
Открыть на GitHub

Что делает 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 контент не удаляет.

Какие задачи решает

  • извлечь таблицы с объединёнными ячейками из 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-tools

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill pdf-tools -a claude-code

2Вручную: положить файлы

~/.claude/skills/pdf-tools/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/pdf-tools/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о pdf-tools

Как установить pdf-tools в Claude Code?

Выполни команду npx skills add oakoss/agent-skills --skill pdf-tools -a claude-code. Скилл появится по пути ~/.claude/skills/pdf-tools/SKILL.md.

Что делает скилл pdf-tools?

Он передаёт агенту карту инструментов и решений для полного цикла работы с PDF: извлечение, генерация через Puppeteer, изменение через pdf-lib, заполнение форм, шифрование и цифровые подписи.

Работает ли pdf-tools в edge и serverless-окружениях?

Для edge подходит unpdf — он совместим с serverless. Puppeteer там не запустится, потому что требует полноценного Node.js-окружения; скилл это различает.

Исходный текст

SKILL.md · MIT
---
name: pdf-tools
description: 'PDF engineering for extraction, generation, modification, and form filling. Use when extracting text or tables from PDFs, generating PDFs with Puppeteer, modifying PDFs with pdf-lib, filling PDF forms, or implementing PDF security. Use for AI-assisted OCR, HTML-to-PDF conversion, and document processing pipelines.'
license: MIT
metadata:
  author: oakoss
  version: '1.1'
---

# PDF Tools

Full-lifecycle PDF engineering covering extraction, generation, modification, form filling, and security. Prioritizes JavaScript-first solutions (pdf-lib, unpdf, Puppeteer) with Python/CLI utilities for advanced scenarios.

**When to use**: Extracting structured data from PDFs, generating pixel-perfect PDFs from HTML/React, modifying existing PDFs, filling forms (fillable or non-fillable), or securing documents with encryption.

**When NOT to use**: Simple text file processing, image-only manipulation without PDF context, or tasks better handled by a word processor.

## Quick Reference

| Task                       | Tool                          | Key Point                                                                  |
| -------------------------- | ----------------------------- | -------------------------------------------------------------------------- |
| Generate PDF from HTML     | Puppeteer / Playwright        | `page.pdf()`; use `networkidle0` (Puppeteer) or `networkidle` (Playwright) |
| Extract text (lightweight) | unpdf                         | Edge/serverless compatible                                                 |
| Extract tables (AI)        | Vision model + Zod schema     | Multi-column and merged cell support                                       |
| Extract tables (non-AI)    | pdfplumber (Python)           | Precise cell boundary detection                                            |
| Modify, merge, split       | pdf-lib (or `@pdfme/pdf-lib`) | Byte-level PDF manipulation in JS                                          |
| Fill fillable forms        | pdf-lib (or `@pdfme/pdf-lib`) | Inspect AcroForm fields before writing                                     |
| Fill non-fillable forms    | Python annotation scripts     | Visual analysis + bounding box annotations                                 |
| Encrypt PDF                | qpdf                          | AES-256: `qpdf --encrypt user owner 256 --`                                |
| Repair corrupted PDF       | qpdf                          | `qpdf input.pdf --replace-input`                                           |
| Fast text extraction (CLI) | poppler-utils                 | `pdftotext -layout input.pdf -`                                            |
| Merge thousands of files   | pypdf (Python)                | Lighter than headless browser                                              |
| Batch queue processing     | BullMQ + unpdf                | Redis-backed with retry, concurrency, progress tracking                    |
| PDF/A archival compliance  | ghostscript + verapdf         | `gs -dPDFA=2` for conversion; verapdf for validation                       |
| Tagged PDF (accessibility) | Puppeteer                     | `tagged: true` maps HTML semantics to PDF structure tags                   |
| Digital signatures         | @signpdf/\*                   | PKCS#7 signing with P12 certificates                                       |
| PDF comparison             | unpdf + diff / pixelmatch     | Text diff or pixel-level visual diff between versions                      |
| Secure redaction           | pymupdf (fitz)                | `apply_redactions()` removes content bytes, not just visual overlay        |

## Common Mistakes

| Mistake                                                | Correct Pattern                                                   |
| ------------------------------------------------------ | ----------------------------------------------------------------- |
| Using canvas drawing commands for PDF generation       | Use Puppeteer/Playwright with HTML/CSS templates                  |
| Running Puppeteer in edge/serverless environments      | Use unpdf for edge; Puppeteer requires full Node.js               |
| Extracting complex layouts with basic text parsers     | Use AI-assisted OCR or pdfplumber for multi-column text           |
| Storing unencrypted PDFs with PII in public storage    | Apply AES-256 encryption via qpdf before storage                  |
| Relying on `window.print()` for server-side generation | Use headless browser APIs (`page.pdf()`) for deterministic output |
| Using pypdf for complex layout extraction              | Use pdfplumber or AI OCR for multi-column or overlapping text     |
| Skipping font embedding in containerized environments  | Embed Google Fonts or WOFF2 files with Puppeteer                  |
| Writing to flattened PDF form fields                   | Inspect AcroForm fields with pdf-lib before writing               |
| Using unmaintained `pdf-lib` for encrypted PDFs        | Use `@cantoo/pdf-lib` fork which adds encrypted PDF support       |

## Delegation

- **Inspect PDF structure and diagnose extraction issues**: Use `Explore` agent to examine AcroForm fields, encoding, and metadata
- **Build end-to-end document processing pipelines**: Use `Task` agent to implement extraction, transformation, and generation workflows
- **Design PDF architecture for a new system**: Use `Plan` agent to select tools and plan extraction, generation, or modification strategies

## References

- [AI Extraction Patterns](references/ai-extraction-patterns.md) -- Vision-based table extraction, recursive summarization, multi-pass verification
- [High-Fidelity Generation](references/high-fidelity-generation.md) -- Puppeteer HTML-to-PDF, CSS print tips, React templates, browser pooling
- [Legacy Utilities](references/legacy-utilities.md) -- pdfplumber, pypdf, qpdf, poppler-utils for batch and forensic tasks
- [Form Filling](references/form-filling.md) -- Fillable field extraction, non-fillable annotation workflow, validation scripts
- [Batch Processing and Accessibility](references/batch-and-accessibility.md) -- Queue-based batch processing, PDF/A compliance, tagged PDFs, digital signatures, comparison, redaction

© oakoss · MIT · oakoss/agent-skills

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
pdf-to-markdown lttr Скилл pdf-to-markdown распознаёт отсканированные и графические PDF-документы через визуальное чтение и сохраняет чистый Markdown рядом с оригиналом. CX Codex +1 5установок pdf-toolkit-mcp AryanBV MCP-сервер pdf-toolkit-mcp с 22 инструментами для чтения, сборки, шифрования и слияния PDF. Рендерит страницы в изображения, чтобы модель прочитала отсканированный документ без текстового слоя. CX Codex +1 ★ 12звёзд репо pdf-generator agent-skills Скилл pdf-generator для работы с PDF из терминала: заполняет формы, ставит водяные знаки, склеивает документы и собирает новые файлы из JSON-описания. CX Codex +1 927установок html-to-pdf aviz85 Скилл html-to-pdf преобразует веб-страницы и HTML-разметку в PDF через безголовый Chrome с автоматическим определением RTL и поддержкой иврита. CX Codex +1 1 300установок document-generation-pdf curiositech Скилл document-generation-pdf для Claude Code создаёт, заполняет и собирает PDF-документы. Активируется для генерации PDF, заполнения форм и цифровых подписей. CX Codex +1 283установок pdf nexu-io Извлекает текст, собирает PDF-документы и заполняет формы. Помогает оформлять пресс-релизы, одностраничники и печатные макеты. CX Codex +1 3 200установок

Из того же набора106

Весь набор →
openapi Настраивает агента на проектирование спецификаций OpenAPI 3.1 и генерацию TypeScript-клиентов. Помогает писать схемы контрактов и документацию для REST API. CX Codex +1 197установок css-animation-patterns Скилл css-animation-patterns для Claude Code помогает создавать CSS-анимации без перерисовки макета. Описывает аппаратно ускоренные свойства, переходы и новые API движения. CX Codex +1 196установок pnpm-workspace Скилл pnpm-workspace настраивает монорепозитории на базе pnpm и каталоги версий. Помогает агенту связывать локальные пакеты через протокол workspace:. CX Codex +1 195установок icon-design Скилл icon-design помогает выбрать подходящие по смыслу иконки из Lucide, Heroicons или Phosphor и настроить чистый импорт без поломки tree-shaking. CX Codex +1 187установок ssh-remote Скилл ssh-remote помогает ассистенту настраивать SSH-подключения, генерировать ключи Ed25519, пробрасывать порты и безопасно передавать файлы. CX Codex +1 183установок tanstack-hotkeys Скилл для агента: подсказывает, как собрать горячие клавиши в React на TanStack Hotkeys — от одиночных комбинаций до записи пользовательских шорткатов. CX Codex +1 179установок technical-docs Скилл technical-docs для Claude Code помогает писать и обновлять техническую документацию, строить диаграммы Mermaid и сверять документацию с кодом. Помогает вести doc-as-code и проверять покрытие. CX Codex +1 177установок mermaid-diagrams Скилл mermaid-diagrams помогает создавать Mermaid-диаграммы в Markdown: от блок-схем и ERD до графиков, mindmap и архитектурных схем. CX Codex +1 177установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой