# pdf-to-structured

Скилл pdf-to-structured парсит таблицы, ведомости материалов и отчёты из PDF в Excel, CSV и JSON. Работает со сканами через OCR и с исходными PDF-файлами через pdfplumber.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 149 установок · ★ 434 у репозитория
- Автор: datadrivenconstruction
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction/tree/HEAD/2_DDC_Book/2.4-PDF-CAD-to-Data/pdf-to-structured/SKILL.md
- Обновлён: 2026-10-19
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/pdf-to-structured

## Что делает

Скилл содержит инструкции и Python-скрипты для извлечения информации из проектной документации. Для стандартных PDF используется библиотека `pdfplumber`: она читает разметку страниц, выгружает таблицы с сохранением структуры колонок и умеет обрезать конкретные области листа по координатам bounding box.

Для сканированных документов подключается распознавание через `pytesseract` и `pdf2image`. Скрипт переводит страницы в растр с разрешением 300 DPI, применяет бинаризацию в OpenCV и парсит строки в табличную модель. На выходе формируются таблицы `pandas`, которые сохраняются в форматы `.xlsx` или `.csv`.

Для запуска сканов в системе обязательно должен стоять бинарник Tesseract OCR. Без установленного `python3` и модулей `pandas` с `openpyxl` обработка таблиц не сработает.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill pdf-to-structured -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill pdf-to-structured -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill pdf-to-structured -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction 2_DDC_Book/2.4-PDF-CAD-to-Data/pdf-to-structured
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill pdf-to-structured -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --path 2_DDC_Book/2.4-PDF-CAD-to-Data/pdf-to-structured
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill pdf-to-structured -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction/tree/HEAD/2_DDC_Book/2.4-PDF-CAD-to-Data/pdf-to-structured/SKILL.md

## Когда брать
- сконвертировать ведомость материалов из PDF в таблицу Excel
- распознать текст и таблицы со сканированных страниц документации
- выгрузить таблицу из заданной области листа по координатам
- сохранить структуру отчёта с разбивкой на страницы в текстовый файл

## Примеры запросов агенту
- Извлеки все таблицы из `material_specification.pdf` и сохрани их в `materials.xlsx`
- Запусти OCR для `scanned_bom.pdf` и собери ведомость в файл `bom.csv`
- Вытащи таблицу из первой страницы `drawing.pdf` в координатах `50, 100, 550, 400`

## Похожие
- [pdf-processing-pro](https://affpapa.org/nevibecode/skills/pdf-processing-pro.md) — скилл · 5869 установок
- [pdf](https://affpapa.org/nevibecode/skills/nous-research-pdf.md) — скилл · 283 установки
- [pdf-reading](https://affpapa.org/nevibecode/skills/pdf-reading.md) — скилл · ★ 116 у репозитория
- [pdf-extraction](https://affpapa.org/nevibecode/skills/pdf-extraction.md) — скилл · 9600 установок
- [liteparse](https://affpapa.org/nevibecode/skills/k-dense-ai-liteparse.md) — скилл · 1700 установок
- [openai-pdf](https://affpapa.org/nevibecode/plugins/openai-pdf.md) — плагин · ★ 540 у репозитория

Из того же набора: [datadrivenconstruction/ddc_skills_for_ai_agents_in_construction](https://affpapa.org/nevibecode/by/datadrivenconstruction/ddc_skills_for_ai_agents_in_construction.md) — 156 карточек

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

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