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

pdf · appautomaton — скилл для Claude Code: что делает и как установить

Скилл читает, создаёт, заполняет и меняет PDF. Он пригодится для форм, сканов, таблиц и подготовки итогового файла.

MIT 720 установок ★ 190 обновлён 2026-10-15

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

Что делает pdf

Скилл помогает извлекать текст и таблицы, распознавать сканы, заполнять интерактивные и плоские формы, а также создавать PDF через reportlab. Для обработки существующих файлов используются pdfplumber и pypdf; отдельные скрипты проверяют поля форм и показывают страницы как изображения.

Через pypdf можно объединять, разделять, поворачивать, обрезать, штамповать и шифровать документы. После изменения PDF скилл советует отрендерить затронутые страницы и проверить текст, границы и расположение значений. Для рендеринга нужен poppler с pdftoppm, для OCR — Tesseract, а AES-шифрование требует pypdf[crypto]. Без poppler просмотр страниц через скрипт не запустится.

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

  • извлечь текст из PDF и сохранить структуру строк
  • распознать текст на отсканированных страницах
  • заполнить интерактивную или плоскую форму
  • объединить, разделить или повернуть страницы
  • проверить расположение полей перед выдачей файла

Примеры запросов агенту

  • Извлеки текст и таблицы из report.pdf, сохрани результат в удобном для анализа виде.
  • Заполни форму в application.pdf по данным из values.json, проверь поля и создай итоговый PDF.
  • Отрендери страницы out.pdf в каталог check и проверь страницы 1-3 на обрезанный текст и перекрытия.

Как установить pdf

1Через Skills CLI (Vercel)

npx skills add appautomaton/document-SKILLs --skill pdf -a claude-code

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

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

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

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

Вопросы о pdf

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

Выполните npx skills add appautomaton/document-SKILLs --skill pdf -a claude-code, затем откройте ~/.claude/skills/pdf/SKILL.md.

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

Он читает и создаёт PDF, извлекает текст и таблицы, распознаёт сканы, заполняет формы и выполняет операции над страницами: объединение, разделение, поворот, штамп и шифрование.

Что нужно для рендеринга и OCR PDF?

Рендеринг страниц требует poppler с командой pdftoppm, а OCR — Tesseract. Для AES-шифрования нужна зависимость pypdf[crypto].

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

SKILL.md · MIT
---
name: pdf
description: Read, create, fill, and transform PDF files. Covers extracting text and tables, OCR of scanned pages, filling fillable and flat forms, and flattening, merging, splitting, rotating, stamping and encrypting. Use when a task takes a .pdf as input or must produce one.
---

# PDF files

You already know pypdf, pdfplumber and reportlab. This skill adds what they don't give you: form-filling scripts that check their own input, a way to see pages as a reader will, and the PDF behaviours that silently put content in the wrong place.

## Running scripts

`<skill>` is the directory containing this file. Run bundled scripts by absolute path from the user's working directory, so relative paths to their files keep working:

```bash
uv run <skill>/scripts/convert_pdf_to_images.py report.pdf pages
```

Run Python you write with its dependencies declared, either `uv run --with pypdf script.py` or a PEP 723 header. Rendering pages needs poppler (`pdftoppm`); OCR also needs Tesseract.

## Choosing a tool

| Task | Use |
|---|---|
| Fill a form, fillable or flat | [forms.md](forms.md), always. It has scripts for every step. |
| Text | pdfplumber, or `pdftotext -layout` from the command line. Text missing from pages that visibly have it means a scan: see [ocr.md](ocr.md). |
| Tables | pdfplumber: see [tables.md](tables.md) |
| New PDFs | reportlab: Platypus for flowing documents, canvas for exact placement |
| Merge, split, rotate, crop, stamp, encrypt | pypdf: see [reference.md](reference.md) for the calls that keep bookmarks, links and orientation intact |
| See what a page looks like | `scripts/convert_pdf_to_images.py` |

## Checking the output

Whenever you create or change a PDF, render the pages you touched and look at them before delivering. Check that the text is present and readable, nothing is clipped or overlapping, and every stamp or value is where it belongs:

```bash
uv run <skill>/scripts/convert_pdf_to_images.py out.pdf check --pages 1-3
```

## Pitfalls that fail silently

- **Two coordinate systems.** PDF coordinates start at the bottom-left of the page box, in points. pdfplumber and page images start at the top-left. The page box need not start at (0, 0), so read `page.cropbox.left` and `.bottom`.
- **Rotated pages.** `/Rotate` turns a page only for display; content and form fields keep unrotated coordinates. Anything placed with a plain scale and y-flip lands in the wrong spot. Convert boxes with `scripts/pdf_coords.py`, and call `page.transfer_rotation_to_content()` before stamping.
- **Non-Latin text in new PDFs.** reportlab's built-in fonts draw Chinese, Cyrillic and similar scripts as black boxes. Register and embed a TrueType font; see [reference.md](reference.md#fonts-for-new-pdfs).
- **Merging.** `PdfWriter.append()` keeps bookmarks and links, while copying pages with `add_page()` drops them. Merged forms with matching field names become one field, so filling one fills both.
- **AES encryption** needs `uv run --with 'pypdf[crypto]'`. Without it, pypdf raises `DependencyError` on open or on encrypt.

## Scripts

| Script | Does |
|---|---|
| `check_fillable_fields.py <pdf>` | Says which form path in forms.md applies |
| `extract_form_field_info.py <pdf> <out.json>` | Lists fillable fields, their pages, boxes and accepted values |
| `fill_fillable_fields.py <pdf> <values.json> <out.pdf>` | Fills fields after checking every id, page and value |
| `convert_pdf_to_images.py <pdf> <dir> [--pages] [--fields]` | Renders pages one at a time to PNG, optionally outlining each fillable field |
| `check_bounding_boxes.py <fields.json> [pdf]` | Finds overlapping or too-short boxes before a flat form is filled |
| `create_validation_image.py <page> <fields.json> <png> <out.png>` | Draws those boxes on a page image for checking by eye |
| `fill_pdf_form_with_annotations.py <pdf> <fields.json> <out.pdf>` | Fills a flat form with text that renders identically everywhere |
| `flatten_form.py <pdf> <out.pdf>` | Draws filled values into the page so they can't be edited |
| `pdf_coords.py <pdf> <page> <WxH> --to-pdf/--to-image <box>` | Converts boxes between page-image pixels and PDF points |

© appautomaton · MIT · appautomaton/document-SKILLs

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

Все скиллы по теме «Документы и офис» →

Сначала — pdf от других авторов.

pdf официальный anthropics Читает, создаёт и меняет PDF-файлы, включая формы и сканы. Обрабатывает PDF в проекте. CX Codex +1 216 041установок pdf официальный openai Читает, создаёт и проверяет PDF через визуальный рендер страниц — агент видит результат, а не только текст. CX Codex +1 14 000установок pdf nexu-io Извлекает текст, собирает PDF-документы и заполняет формы. Помогает оформлять пресс-релизы, одностраничники и печатные макеты. CX Codex +1 3 200установок pdf Nous Research Работает с PDF-файлами: создаёт, читает, объединяет, заполняет формы, извлекает текст и таблицы. CX Codex +1 283установок pdf shareAI-lab Извлекает текст из PDF, создаёт PDF из Markdown и склеивает файлы. CX Codex +1 ★ 80 707звёзд репо pdf-extraction claude-office-skills Скилл pdf-extraction для Claude Code извлекает текст и таблицы из PDF с помощью pdfplumber. Разбирает отчёты и инвойсы, переносит данные в DataFrames. CX Codex +1 9 600установок remove-pdf-watermark pilioai Скилл remove-pdf-watermark удаляет водяные знаки из документов PDF через официальный CLI и API Pilio. Помогает очистить файл для редактирования или пересобрать страницы с помощью ИИ. CX Codex +1 7 400установок nano-pdf openclaw Редактирует PDF-страницы по текстовым инструкциям через CLI nano-pdf. CX Codex +1 7 200установок view-pdf официальный anthropics Скилл view-pdf открывает PDF в интерактивном просмотрщике и помогает размечать документ, заполнять формы и размещать подписи. Подходит для совместной работы по экрану. CX Codex +1 6 500установок pdf-to-docx claude-office-skills Скилл pdf-to-docx для Claude Code конвертирует PDF в редактируемый Word через библиотеку pdf2docx. Правит отчёты и договоры — не читает их. CX Codex +1 6 200установок pdf-processing-pro davila7 Скилл pdf-processing-pro для Claude Code обрабатывает PDF: заполняет формы, извлекает таблицы и распознаёт текст. Включается при пакетной обработке документов. CX Codex +1 5 869установок

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

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

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