Работа с PDF с проверкой вёрстки

Создаёт и проверяет PDF-файлы: отрисовывает страницы в картинки, ловит дефекты вёрстки и извлекает текст инструментами Python.

СкиллOpenAICodexApache-2.0Нужен терминалПроверка не требуется

Скачать на русскомОригинал на английском (архив)Источник ↗

Что делает: Создаёт и проверяет PDF-файлы: отрисовывает страницы в картинки, ловит дефекты вёрстки и извлекает текст инструментами Python.
Когда брать: Когда нужно прочитать, создать или проверить PDF, где важны внешний вид и вёрстка.
Когда не брать: Если нужен только текст из PDF без оглядки на оформление.
Пример запроса: Собери PDF-отчёт из этих данных и проверь по картинкам страниц, что вёрстка не поехала.
Нужно подключить: терминал, Python
Работает лучше с: Poppler (pdftoppm), uv

Как включить

Скачайте архив и распакуйте его.
Положите папку pdf в ~/.agents/skills/.
Вызовите скилл командой $pdf или найдите его через /skills.

Текст

---
name: "pdf"
description: "Используй, когда задачи связаны с чтением, созданием или проверкой PDF-файлов, где важны отрисовка и вёрстка; предпочитай визуальную проверку через отрисовку страниц (Poppler) и используй инструменты Python, такие как `reportlab`, `pdfplumber` и `pypdf`, для создания и извлечения данных."
---

Скилл «PDF»

Когда использовать

Читать или проверять содержимое PDF, где важны вёрстка и внешний вид.
Программно создавать PDF с надёжным форматированием.
Проверять итоговую отрисовку перед сдачей.

Рабочий процесс

Предпочитай визуальную проверку: отрисуй страницы PDF в PNG и осмотри их.
Используй pdftoppm, если он доступен.
Если он недоступен, установи Poppler или попроси пользователя проверить результат локально.
Для создания новых документов используй reportlab.
Для извлечения текста и быстрых проверок используй pdfplumber (или pypdf); не полагайся на них в части точности вёрстки.
После каждого значимого изменения заново отрисуй страницы и проверь выравнивание, отступы и читаемость.

Соглашения о временных файлах и результатах

Промежуточные файлы клади в tmp/pdfs/; по окончании удаляй.
Итоговые артефакты записывай в output/pdf/, если работаешь в этом репозитории.
Держи имена файлов стабильными и понятными.

Зависимости (устанавливай, если их нет)

Для управления зависимостями предпочитай uv.

Пакеты Python:

uv pip install reportlab pdfplumber pypdf

Если uv недоступен:

python3 -m pip install reportlab pdfplumber pypdf

Системные инструменты (для отрисовки):

# macOS (Homebrew)
brew install poppler

# Ubuntu/Debian
sudo apt-get install -y poppler-utils

Если установка в этой среде невозможна, сообщи пользователю, какой зависимости не хватает и как установить её локально.

Окружение

Обязательных переменных окружения нет.

Команда отрисовки

pdftoppm -png $INPUT_PDF $OUTPUT_PREFIX

Требования к качеству

Поддерживай аккуратный визуальный стиль: единообразная типографика, отступы, поля и иерархия разделов.
Избегай проблем отрисовки: обрезанного текста, перекрывающихся элементов, сломанных таблиц, чёрных квадратов и нечитаемых символов.
Диаграммы, таблицы и изображения должны быть чёткими, выровненными и понятно подписанными.
Используй только дефисы ASCII. Не используй U+2011 (неразрывный дефис) и другие тире Unicode.
Цитаты и ссылки должны быть читаемы человеком; никогда не оставляй служебные токены инструментов и строки-заглушки.

Итоговые проверки

Не сдавай работу, пока последний осмотр PNG не покажет ни одного дефекта оформления или вёрстки.
Убедись, что колонтитулы, нумерация страниц и переходы между разделами выглядят аккуратно.
Держи промежуточные файлы в порядке или удали их после окончательного одобрения.

Перевод: iiuniversitet. Оригинал: https://github.com/openai/skills/tree/main/skills/.curated/pdf, лицензия Apache-2.0. Изменения: перевод на русский язык.

Оригинал на английском

---
name: "pdf"
description: "Use when tasks involve reading, creating, or reviewing PDF files where rendering and layout matter; prefer visual checks by rendering pages (Poppler) and use Python tools such as `reportlab`, `pdfplumber`, and `pypdf` for generation and extraction."
---

# PDF Skill

## When to use
- Read or review PDF content where layout and visuals matter.
- Create PDFs programmatically with reliable formatting.
- Validate final rendering before delivery.

## Workflow
1. Prefer visual review: render PDF pages to PNGs and inspect them.
- Use `pdftoppm` if available.
- If unavailable, install Poppler or ask the user to review the output locally.
2. Use `reportlab` to generate PDFs when creating new documents.
3. Use `pdfplumber` (or `pypdf`) for text extraction and quick checks; do not rely on it for layout fidelity.
4. After each meaningful update, re-render pages and verify alignment, spacing, and legibility.

## Temp and output conventions
- Use `tmp/pdfs/` for intermediate files; delete when done.
- Write final artifacts under `output/pdf/` when working in this repo.
- Keep filenames stable and descriptive.

## Dependencies (install if missing)
Prefer `uv` for dependency management.

Python packages:
```
uv pip install reportlab pdfplumber pypdf
```
If `uv` is unavailable:
```
python3 -m pip install reportlab pdfplumber pypdf
```
System tools (for rendering):
```
# macOS (Homebrew)
brew install poppler

# Ubuntu/Debian
sudo apt-get install -y poppler-utils
```

If installation isn't possible in this environment, tell the user which dependency is missing and how to install it locally.

## Environment
No required environment variables.

## Rendering command
```
pdftoppm -png $INPUT_PDF $OUTPUT_PREFIX
```

## Quality expectations
- Maintain polished visual design: consistent typography, spacing, margins, and section hierarchy.
- Avoid rendering issues: clipped text, overlapping elements, broken tables, black squares, or unreadable glyphs.
- Charts, tables, and images must be sharp, aligned, and clearly labeled.
- Use ASCII hyphens only. Avoid U+2011 (non-breaking hyphen) and other Unicode dashes.
- Citations and references must be human-readable; never leave tool tokens or placeholder strings.

## Final checks
- Do not deliver until the latest PNG inspection shows zero visual or formatting defects.
- Confirm headers/footers, page numbering, and section transitions look polished.
- Keep intermediate files organized or remove them after final approval.

Источник: openai/skills / pdf ↗. Ссылка проверена 2026-10-10.

---
name: "pdf"
description: "Используй, когда задачи связаны с чтением, созданием или проверкой PDF-файлов, где важны отрисовка и вёрстка; предпочитай визуальную проверку через отрисовку страниц (Poppler) и используй инструменты Python, такие как `reportlab`, `pdfplumber` и `pypdf`, для создания и извлечения данных."
---


# Скилл «PDF»

## Когда использовать
- Читать или проверять содержимое PDF, где важны вёрстка и внешний вид.
- Программно создавать PDF с надёжным форматированием.
- Проверять итоговую отрисовку перед сдачей.

## Рабочий процесс
1. Предпочитай визуальную проверку: отрисуй страницы PDF в PNG и осмотри их.
   - Используй `pdftoppm`, если он доступен.
   - Если он недоступен, установи Poppler или попроси пользователя проверить результат локально.
2. Для создания новых документов используй `reportlab`.
3. Для извлечения текста и быстрых проверок используй `pdfplumber` (или `pypdf`); не полагайся на них в части точности вёрстки.
4. После каждого значимого изменения заново отрисуй страницы и проверь выравнивание, отступы и читаемость.

## Соглашения о временных файлах и результатах
- Промежуточные файлы клади в `tmp/pdfs/`; по окончании удаляй.
- Итоговые артефакты записывай в `output/pdf/`, если работаешь в этом репозитории.
- Держи имена файлов стабильными и понятными.

## Зависимости (устанавливай, если их нет)
Для управления зависимостями предпочитай `uv`.

Пакеты Python:
```
uv pip install reportlab pdfplumber pypdf
```
Если `uv` недоступен:
```
python3 -m pip install reportlab pdfplumber pypdf
```
Системные инструменты (для отрисовки):
```
# macOS (Homebrew)
brew install poppler

# Ubuntu/Debian
sudo apt-get install -y poppler-utils
```

Если установка в этой среде невозможна, сообщи пользователю, какой зависимости не хватает и как установить её локально.

## Окружение
Обязательных переменных окружения нет.

## Команда отрисовки
```
pdftoppm -png $INPUT_PDF $OUTPUT_PREFIX
```

## Требования к качеству
- Поддерживай аккуратный визуальный стиль: единообразная типографика, отступы, поля и иерархия разделов.
- Избегай проблем отрисовки: обрезанного текста, перекрывающихся элементов, сломанных таблиц, чёрных квадратов и нечитаемых символов.
- Диаграммы, таблицы и изображения должны быть чёткими, выровненными и понятно подписанными.
- Используй только дефисы ASCII. Не используй U+2011 (неразрывный дефис) и другие тире Unicode.
- Цитаты и ссылки должны быть читаемы человеком; никогда не оставляй служебные токены инструментов и строки-заглушки.

## Итоговые проверки
- Не сдавай работу, пока последний осмотр PNG не покажет ни одного дефекта оформления или вёрстки.
- Убедись, что колонтитулы, нумерация страниц и переходы между разделами выглядят аккуратно.
- Держи промежуточные файлы в порядке или удали их после окончательного одобрения.

Перевод: iiuniversitet. Оригинал: https://github.com/openai/skills/tree/main/skills/.curated/pdf, лицензия Apache-2.0. Изменения: перевод на русский язык.