# pdf-generator

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

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 916 установок · ★ 176
- Автор: agent-skills
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/jwynia/agent-skills/tree/HEAD/skills/general/document-processing/pdf/pdf-generator/SKILL.md
- Обновлён: 2026-02-24
- HTML: https://affpapa.org/nevibecode/skills/pdf-generator

## Что делает

Скилл закрывает две задачи. Первая — правка готовых PDF: разбор полей формы, подстановка значений, наложение текста, картинок и фигур, объединение нескольких файлов с выбором страниц. Вторая — сборка документа с нуля по JSON: заголовки, линии, таблицы с шириной колонок и высотой строк, размер страницы A4 или Letter.

Внутри два скрипта на Deno. `analyze-template.ts` вытаскивает из PDF текст, метаданные и список полей формы — это нужно, чтобы узнать точные имена полей перед заполнением. `generate-from-template.ts` делает саму работу: заполняет форму, добавляет оверлеи, склеивает файлы. Оба запускаются через `deno run` с флагами `--allow-read` и `--allow-write`.

Deno должен стоять заранее, иначе скрипты просто не запустятся. Для шаблонных операций нужен исходный PDF, для генерации с нуля — JSON-спецификация. Сканы без текстового слоя и PDF с паролем скилл не тянет: для распознавания нужен OCR, для защиты — другой инструмент. Если верстка сложная, с плавающим текстом на много страниц, проще взять HTML-to-PDF.

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install jwynia/agent-skills pdf-generator
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

### Claude.ai

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

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

## Когда брать
- заполнить PDF-форму данными из JSON и сохранить результат
- узнать имена полей в готовом PDF перед подстановкой
- поставить водяной знак или штамп «APPROVED» на страницу
- склеить обложку, приложения и тело отчёта в один файл
- собрать отчёт с таблицей из спецификации

## Примеры запросов агенту
- Разбери поля формы в `application.pdf` и покажи их список
- Заполни `form-template.pdf` данными из `form-data.json` и сохрани в `filled-form.pdf`
- Собери PDF по `report-spec.json` с таблицей продаж

## Похожие
- [pdf](https://affpapa.org/nevibecode/skills/nexu-io-pdf.md) — скилл · 3000 установок
- [k2f-fillable-pdf](https://affpapa.org/nevibecode/skills/k2f-fillable-pdf.md) — скилл · 623 установки
- [translate-pdf](https://affpapa.org/nevibecode/skills/translate-pdf.md) — скилл · 1200 установок
- [PDF Form Filler](https://affpapa.org/nevibecode/skills/pdf-form-filler.md) — скилл · 4700 установок
- [doc](https://affpapa.org/nevibecode/skills/doc.md) — скилл · 99 установок
- [Chat with PDF](https://affpapa.org/nevibecode/skills/chat-with-pdf.md) — скилл · 4800 установок

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

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

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