# document-granular-decompose

Скилл document-granular-decompose отправляет локальные документы в API TianGong AI Unstructure /mineru_with_images и возвращает чистый сплошной текст без лишней JSON-разметки.

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

## Что делает

Скилл запускает Python-скрипт `scripts/mineru_fulltext_extract.py`, который передаёт файл в эндпоинт `/mineru_with_images` через multipart-запрос. Скрипт принудительно задаёт параметр `return_txt=true` и считывает поле `response.txt`. Если оно пустое, утилита объединяет фрагменты из `response.result[].text`. В готовом тексте скрипт автоматически исправляет экранирование подчёркиваний Markdown, заменяя `\_` на символ `_`.

Файлы проверяются локально по строгому списку расширений. Поддерживаются форматы PDF, офисные документы вроде `.docx` или `.xlsx`, а также изображения `.png`, `.jpg` и `.webp`. Неподдерживаемые расширения скрипт отсекает сразу же, не отправляя запрос в сеть.

Без переменных `UNSTRUCTURED_API_BASE_URL` и `UNSTRUCTURED_AUTH_TOKEN` в окружении запуск немедленно завершится ошибкой. Маршрутизацию модели можно при необходимости скорректировать через переменные `UNSTRUCTURED_PROVIDER` и `UNSTRUCTURED_MODEL`.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add tiangong-ai/agent-skills --skill document-granular-decompose -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add tiangong-ai/agent-skills --skill document-granular-decompose -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add tiangong-ai/agent-skills --skill document-granular-decompose -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install tiangong-ai/agent-skills document-granular-decompose
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add tiangong-ai/agent-skills --skill document-granular-decompose -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/tiangong-ai/agent-skills --path document-granular-decompose
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add tiangong-ai/agent-skills --skill document-granular-decompose -a opencode
```

### Claude.ai

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

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

## Когда брать
- извлечь чистый текст из PDF и офисных документов через MinerU
- отфильтровать файлы с неподдерживаемыми расширениями до отправки в сеть
- передать извлечённый текст напрямую в stdout или записать в отдельный файл
- настроить авторизацию к Unstructure API через переменные окружения

## Примеры запросов агенту
- Извлеки весь текст из отчёта `annual_report.pdf` с помощью document-granular-decompose
- Распарси презентацию `slides.pptx` через document-granular-decompose и сохрани результат в `output.txt`

## Похожие
- [MinerU Open MCP](https://affpapa.org/nevibecode/mcp/mineru-open-mcp.md) — MCP-сервер · ★ 231 у репозитория
- [business-document-generator](https://affpapa.org/nevibecode/skills/business-document-generator.md) — скилл · 1400 установок
- [Skywork Document](https://affpapa.org/nevibecode/skills/skywork-document.md) — скилл · 381 установка
- [Unstructured Transform](https://affpapa.org/nevibecode/mcp/unstructured-transform.md) — MCP-сервер · ★ 1 у репозитория
- [azure-ai-translation-document-py](https://affpapa.org/nevibecode/skills/azure-ai-translation-document-py.md) — скилл · 2 установки
- [nutrient-document-processing](https://affpapa.org/nevibecode/skills/nutrient-sdk-nutrient-document-processing.md) — скилл · 490 установок

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

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

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