kordoc-korean-document-parser — скилл для Claude Code: HWP и HWPX
Скилл разбирает корейские документы HWP 5.x, HWPX и PDF в Markdown и структурированные блоки. Пригодится, если надо вытащить текст, таблицы или поля формы.
npx skills add reason-machines/trending-skills --skill kordoc-korean-document-parser -a claude-codeЧто делает kordoc-korean-document-parser
Скилл опирается на библиотеку kordoc — это TypeScript-пакет и CLI. Он читает проприетарный бинарный формат HWP, вытаскивает таблицы, распознаёт поля формы, умеет сравнивать две версии документа и собирать HWPX обратно из Markdown. Формат определяется автоматически по сигнатуре файла, есть отдельные парсеры parseHwp, parseHwpx, parsePdf.
Работать можно тремя способами. Через CLI: npx kordoc document.hwpx печатает результат в stdout, флаг -o пишет в файл, --format json отдаёт блоки с метаданными, watch следит за папкой и конвертирует новые файлы. Через программный API: parse возвращает markdown, blocks, metadata, outline и warnings. Или как MCP-сервер kordoc-mcp с инструментами parse_document, compare_documents, parse_form и другими.
Для PDF нужна отдельная зависимость pdfjs-dist — без неё разбор PDF не заработает. Сканы в PDF распознаются только через подключаемый OCR: в опциях parse передаётся своя асинхронная функция, встроенного движка нет. Если документ зашифрован или это ZIP-бомба, парсер вернёт ошибку с кодом, а не молча пустой результат.
Какие задачи решает
- перевести корейский HWP в Markdown для правки и поиска
- вытащить таблицы из HWPX в структурированном виде
- сравнить две редакции документа и увидеть, что изменилось
- собрать значения полей формы в JSON
- настроить MCP-сервер, чтобы агент сам читал HWP и PDF
Примеры запросов агенту
- разбери
document.hwpxв Markdown и покажи таблицы - сравни
v1.hwpиv2.hwpx, что поменялось - вытащи поля формы из
report.hwp
Как установить kordoc-korean-document-parser
1Через Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill kordoc-korean-document-parser -a claude-code2Вручную: положить файлы
~/.claude/skills/kordoc-korean-document-parser/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/kordoc-korean-document-parser/
1Через Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill kordoc-korean-document-parser -a codex2Вручную: положить файлы
.agents/skills/kordoc-korean-document-parser/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill kordoc-korean-document-parser -a cursor2Вручную: положить файлы
.cursor/skills/kordoc-korean-document-parser/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install reason-machines/trending-skills kordoc-korean-document-parser2Вручную: положить файлы
.github/skills/kordoc-korean-document-parser/SKILL.md1Через Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill kordoc-korean-document-parser -a gemini-cli2Командой платформы
gemini skills install https://github.com/reason-machines/trending-skills --path skills/kordoc-korean-document-parserВручную: положить файлы
.devin/skills/kordoc-korean-document-parser/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill kordoc-korean-document-parser -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о kordoc-korean-document-parser
Как установить kordoc-korean-document-parser в Claude?
Выполните npx skills add reason-machines/trending-skills --skill kordoc-korean-document-parser -a claude-code. Скилл появится в ~/.claude/skills/kordoc-korean-document-parser/SKILL.md.
Что делает kordoc-korean-document-parser?
Разбирает корейские документы HWP 5.x, HWPX и PDF в Markdown и структурированные блоки IRBlock[]. Умеет доставать таблицы, поля формы, метаданные и сравнивать две версии файла.
Что нужно для разбора PDF?
Отдельный пакет pdfjs-dist — он идёт как необязательная peer-зависимость. Для сканов нужен свой OCR-провайдер: в опциях parse задаётся асинхронная функция распознавания.
