# word-document-processor

Скилл для работы с .docx: чтение текста, создание файлов с нуля и правки с отслеживанием изменений. Пригодится, когда агенту нужно тронуть чужой договор или отчёт.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 3600 установок · ★ 46
- Автор: qodex-ai
- Лицензия: LicenseRef-Proprietary · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/qodex-ai/ai-agent-skills/tree/HEAD/skills/word-document-processor/SKILL.md
- Обновлён: 2026-01-05
- HTML: https://affpapa.org/nevibecode/skills/word-document-processor

## Что делает

Скилл закрывает три задачи: разобрать содержимое .docx, собрать новый документ и отредактировать существующий. Для чтения текст выгружается в markdown через pandoc с сохранением правок — флаг `--track-changes=all` показывает вставки и удаления. Если нужны комментарии, встроенные картинки или метаданные, документ распаковывают скриптом `python ooxml/scripts/unpack.py <office_file> <output_directory>` и читают XML напрямую: основной текст лежит в `word/document.xml`, комментарии — в `word/comments.xml`, медиа — в `word/media/`, а правки помечены тегами `<w:ins>` и `<w:del>`.

Новый документ собирается на docx-js: пишете файл на JavaScript или TypeScript из Document, Paragraph и TextRun, экспортируете через `Packer.toBuffer()`. Для правки готового файла есть Python-библиотека Document — она берёт на себя распаковку и упаковку, а при сложных случаях пускает к DOM напрямую. Перед работой скилл требует прочитать целиком `docx-js.md` или `ooxml.md`.

Отдельная ветка — рецензирование чужих документов. Правки планируются в markdown, потом переносятся в OOXML батчами по 3–10 штук, каждый батч проверяется до перехода к следующему. Менять нужно только то, что реально изменилось: неизменённый текст сохраняет исходный `<w:r>` с его RSID, иначе правку тяжело читать. Для юридических, академических, деловых и государственных документов этот путь обязателен. Установка идёт через `npx skills add`, лицензия проприетарная.

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install qodex-ai/ai-agent-skills word-document-processor
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill word-document-processor -a opencode
```

### Claude.ai

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

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

## Когда брать
- вытащить текст из .docx в markdown
- собрать новый документ из JavaScript-кода
- внести правки в чужой договор с отслеживанием
- достать комментарии и картинки из XML
- разбить рецензирование на проверяемые батчи

## Примеры запросов агенту
- прочитай этот .docx и покажи правки
- создай документ с заголовком и таблицей через docx-js
- внеси изменения в раздел 3.2 и оставь их как tracked changes

## Похожие
- [docx](https://affpapa.org/nevibecode/skills/appautomaton-docx.md) — скилл · 1300 установок
- [word-document](https://affpapa.org/nevibecode/skills/word-document.md) — скилл · 790 установок
- [document-processing](https://affpapa.org/nevibecode/skills/document-processing.md) — скилл · 1300 установок
- [translate-book](https://affpapa.org/nevibecode/skills/translate-book.md) — скилл · 1800 установок
- [latex-document-skill](https://affpapa.org/nevibecode/skills/latex-document-skill.md) — скилл · 561 установка
- [doc-to-markdown](https://affpapa.org/nevibecode/skills/doc-to-markdown.md) — скилл · 872 установки

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

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