hwpx-skill

Q: Как создать документ HWPX через скилл?

Составьте JSON-спецификацию, допустимые типы official-letter, brief-report, plan-report и markdown, и выполните python scripts/one_shot.py spec.json --report quality.json. Пробный пример запускает python scripts/one_shot.py --example official-letter.

Q: Как подставить значения в готовый шаблон?

Выведите ключи командой python3 scripts/map_preflight.py dump base.hwpx, проверьте карту командой check, затем python3 scripts/fill_hwpx.py replace base.hwpx out.hwpx --map map.json. Команда residue ищет остатки старых слов в результате.

Скилл создает и правит документы HWPX, конвертирует HWP, собирает официальные письма и отчеты по JSON-спецификации

304 ★ репозитория
Последний коммит 15 сент. 2026

Скилл

jkf87/hwpx-skillАвтор:jkf87

Установка

Работает в: Claude Code
Codex
Koda
Coddy

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/hwpx-skill

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

Агент запускает скрипты Python и, на Windows, PowerShell с `-ExecutionPolicy Bypass` для связи с Hancom Office
Флаг `--break-system-packages` в команде установки пишет пакеты в системный Python
Скилл читает и пересобирает документы, а они могут содержать служебные и персональные данные

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

hwpx-skill работает с форматами корейского офисного пакета Hancom: HWP и HWPX. Скилл для Claude и Codex читает и извлекает текст, правит существующие документы, заполняет шаблоны и создает новые файлы, которые потом можно редактировать в Hancom Office. Новые официальные письма, краткие и плановые отчеты и произвольные документы собирает команда `python scripts/one_shot.py spec.json --report quality.json`: версионная JSON-спецификация проходит проверку качества и сохраняется только после нее. Готовые примеры запускаются флагом `--example`, например `--example official-letter`. Формат HWP сначала переводится в HWPX. Если в Windows установлен Hancom Office, это делает его движок через `scripts/convert_hwp_hancom.ps1`, иначе работает запасной конвертер `python3 scripts/convert_hwp.py input.hwp -o output.hwpx` на Node.js 18 или новее с закрепленным рантаймом rhwp WASM. Оригинал остается нетронутым. Для форм есть замена по карте (`scripts/fill_hwpx.py`) с предварительной проверкой ключей и поиском остатков (`scripts/map_preflight.py`). Среди остальных сценариев: стандартный проект документа по форме министерства внутренних дел и безопасности Кореи с автоматической проверкой оформления (`scripts/gonmun.py`, `scripts/gonmun_lint.py`), пресс-релиз по образцу государственного бланка, листы заданий для учеников из HTML K-Teacher (`scripts/html2hwpx.py`) и пара «листок с задачей и листок для ответов». Для проверки страниц `render_hwpx.py` рендерит PDF и PNG через Hancom. Скилл поддерживает Codex и модель gpt-6-astra, но сам на нее не переключается.

Для кого. Сотрудникам корейских учреждений, учителям и технописателям, которым агент должен готовить документы HWPX: официальные письма, отчеты, формы и листы заданий.

Подходит, если

Официальный документ или отчет в формате HWPX собирается по JSON-спецификации с проверкой качества
Файл .hwp приходится превращать в .hwpx, читать или править без потери оригинала
В шаблон формы подставляются значения, и в результате не должно остаться старых слов (`map_preflight.py residue`)
Документ нужно оформить по правилам министерства: форма проекта документа с автоматической проверкой
Листы заданий из K-Teacher должны стать редактируемыми документами HWPX

Не подходит, если

Документы нужны в DOCX или PDF: скилл работает только с форматами Hancom
Сложная верстка с тенями и фигурами должна совпасть с оригиналом до пикселя: после конвертации они могут отличаться
Нужна гарантия одинакового качества у разных моделей: README прямо отказывается ее давать

Пример запроса к агенту

Преобразуй `input.hwp` в HWPX без потери оригинала и составь по JSON-спецификации краткий отчет в формате HWPX

Ограничения

Скилл рассчитан только на документы Hancom. README и инструкции написаны по-корейски.
Быстрая конвертация HWP идет через Hancom Office на Windows. Без него работает запасной путь на Node.js 18 или новее.
После перевода из HWP могут измениться тени таблиц, сложные фигуры, интервалы и разрывы страниц: важный документ стоит сохранить рядом с оригиналом и просмотреть в Hancom.
Статическая проверка, открытие в Hancom и просмотр страниц считаются разными вещами, а равенство качества у разных моделей не заявлено.

Как отключить. Скилл лежит среди скиллов агента, его убирают оттуда удалением папки. Установленные пакеты `python-hwpx` и `lxml` снимает `pip uninstall python-hwpx lxml`.

Частые вопросы

Как создать документ HWPX через скилл?

Составьте JSON-спецификацию, допустимые типы `official-letter`, `brief-report`, `plan-report` и `markdown`, и выполните `python scripts/one_shot.py spec.json --report quality.json`. Пробный пример запускает `python scripts/one_shot.py --example official-letter`.

Как открыть файл HWP?

Сначала конвертируйте его в HWPX: на Windows с Hancom Office работает `scripts/convert_hwp_hancom.ps1`, иначе `python3 scripts/convert_hwp.py input.hwp -o output.hwpx`. Оригинал остается нетронутым.

Нужен ли Hancom Office?

Нет, но он ускоряет конвертацию и нужен для просмотра страниц. Без него HWP конвертирует запасной путь на Node.js 18 или новее.

Чем скилл отличается от claw-hwp?

claw-hwp читает, создает и правит документы без Hancom и без конвертации. hwpx-skill добавляет сборку по JSON-спецификации с проверкой качества, формы министерства и конвертацию HWP через движок Hancom.

Как подставить значения в готовый шаблон?

Выведите ключи командой `python3 scripts/map_preflight.py dump base.hwpx`, проверьте карту командой `check`, затем `python3 scripts/fill_hwpx.py replace base.hwpx out.hwpx --map map.json`. Команда `residue` ищет остатки старых слов в результате.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

claw-hwp

Скилл читает, создает и правит корейские документы hwp и hwpx прямо из агента, без Hancom Office и без конвертации

СкиллРасширенный доступ218

kordoc

CLI и MCP-сервер переводят корейские HWP и HWPX, PDF и Office-файлы в Markdown и заполняют формы по шаблонам

MCP-серверШирокий доступ2,9 тыс.

Kami

Скилл верстает по шаблонам резюме, одностраничники, письма, отчеты и слайды в PDF, PNG и PPTX и проверяет результат скриптами до выдачи

СкиллРасширенный доступ12,3 тыс.

huashu-md-html

Скилл-конвейер документов: что угодно в markdown, markdown в аккуратный html и docx уровня издательства, html обратно в markdown

СкиллРасширенный доступ939

best-skills

16 готовых скиллов для Cursor, Claude Code и Codex: диссертации, PDF и Office, схемы draw.io, документация проекта

СкиллРасширенный доступ3,1 тыс.

WPS Skills

MCP-сервер и четыре скилла для WPS Office: таблицы, документы и презентации правятся из Claude Code и Cursor обычными фразами

MCP-серверРасширенный доступ686

Коротко о README

README на корейском начинается с описания скилла и блока быстрой генерации по JSON-спецификации. Затем описаны поддержка Codex и модели gpt-6-astra, шлюз замены для форм, таблица из одиннадцати рабочих процессов от A до K, зависимости и быстрые рецепты: конвертация HWP, документ из Markdown, листы K-Teacher, форма министерства, пресс-релиз и плановый документ.

Бейдж для README

Исходный SKILL.md

---
name: hwpx
description: "한글 HWP/HWPX 파일의 변환·읽기·편집과 편집 가능한 .hwpx 문서 생성. 한글 파일, HWP 변환, HWPX 공문·보고서·계획서·활동지, 기존 한글 양식 채우기 요청에 사용한다."
---

# 편집 가능한 고품질 한글 문서

모델은 요구 이해와 원고 구성에 집중하고, 코드는 입력 계약·자원·내용 보존·파일 저장을 검증한다. 같은 명세의 재현성과 서로 다른 모델의 결과 일관성은 별개다. 실제 모델 비교 없이 후자를 보장하지 않는다.

아스트라(Astra, `gpt-6-astra`)를 사용하는 Codex 환경을 지원한다. 집필·도식 설계·검토에 사용자 지정 모델과 추론 설정을 유지하며, 사용자 요청 없이 Astra로 전환하거나 추가 모델을 호출하지 않는다. Astra와 Luna 모두 같은 입력 계약·검사 경로를 사용한다.

## 새 문서

1. 사용자 요청의 사실·필수 조건·미확정 사항을 정리한다. 기관명·연도·장소·문서번호 등을 추측하지 않는다.
- 문서에 필요하지만 미정인 사실과, 요청상 생략하는 항목은 다르다. 일반 지식 보고서에 기관·작성일을 쓰지 않는다는 이유만으로 unknowns나 초안 표시를 만들지 않는다.
2. 아래 문서 유형을 고르고 실행 가능한 예시와 스키마를 확인한다.
3. 기본 문서는 v1 Markdown/공문 JSON을 사용한다. 사실 계약·표 도식·기관별 표현이 필요하면 v2의 의미 블록을 사용한다. 모델이 XML이나 셀 좌표를 작성할 필요는 없다.
- 공문 키는 예시의 `기관명`, `수신`, `제목`, `발신명의`, `body`를 그대로 사용한다. 영문 별칭을 추측하지 않는다.
- 절차도·흐름도·추진체계도 요청은 `diagram` 블록과 `visual-elements.md`로 연결한다. 단계가 나열된 일반 데이터 표만으로 도식 요청을 충족했다고 판단하지 않는다.
4. 명세를 파일로 저장해 한 번 빌드한다. `ok`, `published`, `draft`, 미수행 검사 상태를 확인한다.
5. 완성본은 가능한 경우 실제 한컴 페이지를 렌더하고 육안 검토한다. 정적 통과, 한컴 열림, 렌더 성공, 시각 검토를 같은 것으로 취급하지 않는다.

아래 명령은 **이 SKILL.md가 있는 디렉터리**를 기준으로 한다. 다른 작업 디렉터리에서는 스크립트 경로를 해당 스킬의 절대 경로로 바꾼다. 특정 환경변수가 자동 설정된다고 가정하지 않는다.

```text
python scripts/one_shot.py --example official-letter
python scripts/one_shot.py --example diagram
python scripts/one_shot.py --schema
python scripts/one_shot.py /absolute/path/spec.json --report /absolute/path/quality.json
```

명세의 상대 경로는 명세 파일 위치 기준이며, `source` 원고 속 그림 경로는 원고 위치 기준이다. 출력은 .hwpx여야 한다. 명세·원고·그림·출력·리포트가 충돌하면 사전에 거부한다.

| 유형 | 입력과 용도 |
|---|---|
| `official-letter` | `document` 객체. 시행 공문·기안문, 붙임 안내·결재 필드 |
| `brief-report` | Markdown 또는 v2 블록. 결재선·제목 띠가 있는 요약보고 |
| `plan-report` | Markdown 또는 v2 블록. 장 배너·선택적 표지가 있는 계획·검토보고 |
| `research-plan` | 연구학교 연구계획서 완본(28쪽, 표지·실태분석·SWOT·추진체계도 도식·실행계획 표). `scripts/research_plan.py`로 복제·생성 |
| `markdown` | 범용 보고서·회의록·제안서. `template` 스타일 선택 가능 |

Сообщить о проблеме