Skip to content

hashgraph-online/awesome-codex-plugins / plugins/alpoxdev/hypercore/skills/hyper-hwp

hyper-hwp

Verified

Use this skill when the document to read, fill, edit, or produce is a Korean HWP or HWPX file - a .hwp/.hwpx report, 기안문, 공문서, 별지 서식, 신청서 with form fields, or a table that has to come out of one. It drives the rhwp CLI: read text and structure, extract tables and form fields, replace or insert text and table cells, fill fields, insert footnotes, scaffold a new document from a JSON spec, convert HWPX to HWP5, and gate the result with roundtrip and layout checks. Do not use for PDF, DOCX, XLSX, or PPTX files, Hangul word-processor automation through its own COM or UI, or scanned-image OCR.

references/research-2026-11-13.ko.md

View on GitHub
# HWP 도구 조사, 2026-11-13

## 1. 조사를 먼저 한 이유

한글 문서는 .hwp 3.x, .hwp 5.x, .hwpx 세 가지 모양으로 오고 그 주변 생태계는 파서 라이브러리, 형식별 생성기, MCP 포장, 완성형 편집기로 갈려 있습니다. 하나를 고르는 결정은 작업보다 오래가므로 이 파일을 읽거나 쓴다고 주장하는 후보를 모두 모아 별점, 라이선스, 최근 푸시, 주 언어를 재고 상위 후보는 소스 수준에서 읽었습니다.

> `last_verified_at: 2026-11-13`

방법은 `gh api`로 별점, 라이선스, 최근 푸시, 주 언어를 받고, 상위 후보를 blobless 클론한 뒤 `git show HEAD:<경로>`로 README가 아니라 실제 진입점과 스킬 문서를 읽은 것입니다.

## 2. 조사 범위

저장소 27개를 별점 순으로 적었습니다. "최근 푸시"는 기본 브랜치의 마지막 갱신일이고 배포일이 아닙니다.

| # | 저장소 | 별점 | 라이선스 | 최근 푸시 | 언어 | 성격 | 판단 |
|---|---|---|---|---|---|---|---|
| 1 | [edwardkim/rhwp](https://github.com/edwardkim/rhwp) | 4119 | MIT | 2026-11-13 | Rust | 뷰어, 편집기, CLI, wasm | **채택**: 바이너리 하나로 읽기·편집·생성·변환·검증 |
| 2 | [chrisryugj/kordoc](https://github.com/chrisryugj/kordoc) | 2990 | MIT | 2026-11-13 | TypeScript | 문서 에이전트와 공문서 검수기 | 공문서 관례를 `gongmunseo` 참고자료에서 가져옴 |
| 3 | [hahnlee/hwp.js](https://github.com/hahnlee/hwp.js) | 1306 | Apache-2.0 | 2025-01-10 | TypeScript | HWP5 파서와 뷰어 | 읽기 전용. 2025년이 마지막 |
| 4 | [neolord0/hwplib](https://github.com/neolord0/hwplib) | 587 | Apache-2.0 | 2026-09-11 | Java | HWP5 객체 모델 | JVM 전용이고 CLI가 없음 |
| 5 | [Canine89/hwpxskill](https://github.com/Canine89/hwpxskill) | 336 | none | 2026-06-27 | Python | HWPX 생성 스킬 | 라이선스가 없어 재사용 불가 |
| 6 | [jkf87/hwpx-skill](https://github.com/jkf87/hwpx-skill) | 309 | none | 2026-10-31 | Python | HWPX 생성 스킬 | 라이선스 없음. 공문서 규칙 페이지만 2차 출처로 인용 |
| 7 | [mete0r/pyhwp](https://github.com/mete0r/pyhwp) | 303 | NOASSERTION | 2026-05-19 | Python | HWP5 파서 | 파서뿐 |
| 8 | [jkf87/hwp-mcp](https://github.com/jkf87/hwp-mcp) | 270 | none | 2026-09-27 | Python | MCP 포장 | 라이선스 없음 |
| 9 | [postmelee/alhangeul-macos](https://github.com/postmelee/alhangeul-macos) | 246 | MIT | 2026-11-12 | Swift | 맥 뷰어와 내보내기 | 앱 형태라 셸 작업에서 부를 수 없음 |
| 10 | [hahnlee/hwp-rs](https://github.com/hahnlee/hwp-rs) | 233 | Apache-2.0 | 2022-11-11 | Rust | 파서와 도구 | 2022년 이후 중단 |
| 11 | [DoHyun468/claw-hwp](https://github.com/DoHyun468/claw-hwp) | 222 | MIT | 2026-11-12 | JavaScript | JS 라이브러리 위의 에이전트 스킬 | 명령 표면이 rhwp보다 얇음 |
| 12 | [Indosaram/hwpers](https://github.com/Indosaram/hwpers) | 191 | MIT | 2026-09-06 | Rust | HWP5 파서 라이브러리 | 라이브러리뿐 |
| 13 | [neolord0/hwpxlib](https://github.com/neolord0/hwpxlib) | 187 | Apache-2.0 | 2026-08-31 | Java | HWPX 객체 모델 | JVM 전용 |
| 14 | [msjang/pypandoc-hwpx](https://github.com/msjang/pypandoc-hwpx) | 187 | MIT | 2025-12-18 | Python | 마크다운·docx·html → hwpx | 한 방향뿐 |
| 15 | [airmang/python-hwpx](https://github.com/airmang/python-hwpx) | 123 | Apache-2.0 | 2026-11-13 | Python | 순수 파이썬 HWPX 읽기·편집·생성 | HWPX 전용 대안으로는 그럴듯함 |
| 16 | [roboco-io/hwp2md](https://github.com/roboco-io/hwp2md) | 118 | MIT | 2026-10-11 | Go | HWP → 마크다운 | 한 방향뿐 |
| 17 | [treesoop/hwp-mcp](https://github.com/treesoop/hwp-mcp) | 107 | MIT | 2026-11-01 | TypeScript | MCP 읽기·쓰기 서버 | MCP 호스트가 필요하고 셸 경로가 없음 |
| 18 | [openhwp/openhwp](https://github.com/openhwp/openhwp) | 93 | MIT | 2025-12-12 | Rust | 라이브러리, 뷰어, 편집기 야심 | 동작하는 CLI가 아님 |
| 19 | [kwakseongjae/auto-hwp](https://github.com/kwakseongjae/auto-hwp) | 42 | Apache-2.0 | 2026-11-13 | Rust | 브라우저 HWP 편집기 | 브라우저 형태 |
| 20 | [Dayoooun/hwpx-mcp](https://github.com/Dayoooun/hwpx-mcp) | 35 | MIT | 2026-11-05 | TypeScript | 도구 125개짜리 MCP 서버 | MCP 호스트가 필요 |
| 21 | [volexity/hwp-extract](https://github.com/volexity/hwp-extract) | 29 | BSD-3-Clause | 2025-12-01 | Python | 악성코드 분석용 추출 | 추출뿐 |
| 22 | [UpstageAI/korean-report-hwpx](https://github.com/UpstageAI/korean-report-hwpx) | 22 | MIT | 2026-11-10 | Python | 공문서 보고서 생성기 | 생성뿐이고 편집 없음 |
| 23 | [kist-aix/hwpx](https://github.com/kist-aix/hwpx) | 20 | MIT | 2026-07-01 | Python | 공공기관 보고서 스킬 | 서식 집합이 좁음 |
| 24 | [ai-screams/HwpForge](https://github.com/ai-screams/HwpForge) | 20 | Apache-2.0 | 2026-11-13 | Rust | HWPX 제어 라이브러리 | HWPX 전용이고 이력이 짧음 |
| 25 | [y5496694/narae_hangul](https://github.com/y5496694/narae_hangul) | 15 | MIT | 2026-10-28 | Python | CLI, 스킬, 서식 패키지 | 작고 검증되지 않음 |
| 26 | [kangdacool/hwpx-editing-skill](https://github.com/kangdacool/hwpx-editing-skill) | 8 | MIT | 2026-10-12 | Python | HWPX 편집 검증 스킬 | 검증 아이디어만 참고 |
| 27 | [6aneffy/hwpx-kit](https://github.com/6aneffy/hwpx-kit) | 3 | Apache-2.0 | 2026-07-22 | Python | 서식 채우기, 메일머지 | 의존하기에 너무 작음 |

## 3. rhwp를 고른 이유

기준 네 가지를 이 순서로 봤습니다.

1. **바이너리 하나로 모든 방향.** 읽기(`export-text`, `export-structure`, `export-tables`), 편집(`replace-text`, `set-cell`, `fill-fields`, `insert-*`), 생성(`scaffold`), 변환(`convert`, `export-hwpx`), 검증(`hwpx-roundtrip`, `hwp5-roundtrip`, `layout-anomaly`, `verify`)을 모두 합니다. 다른 후보는 이 그림의 화살표 하나씩만 가집니다. 가장 가까운 `airmang/python-hwpx`와 `ai-screams/HwpForge`는 HWPX 전용이라 한국 사무실이 실제로 들고 있는 .hwp 파일을 다루지 못합니다.
2. **기계가 읽는 계약.** `rhwp capabilities`가 바이너리 자신의 명령과 옵션 목록을 JSON으로 출력하므로, 탐지 스크립트가 편집 도중 없는 플래그에서 실패하는 대신 오래된 바이너리를 먼저 알아봅니다. 이걸 노출하는 후보는 없습니다.
3. **지금 관리됨.** 최근 푸시 2026-11-13, v0.9.0 공개 2026-11-08, 포크 361개입니다. 별점 상위 대안 넷 중 셋은 2025년 이전에 마지막 손질이 있었고 `hwp-rs`는 2022년에 멈췄습니다.
4. **MIT이고 관리자가 쓴 에이전트 안내서가 있음.** `mydocs/manual/rhwp_cli_skill_guide.md`와 `agent_toolkit_cli.md`가 의도된 에이전트 사용법을 설명합니다. 스크립트로 쓸 수 있게 된 도구와 그렇게 쓰도록 만든 도구의 차이입니다.

rhwp에 없고 확인한 것도 적습니다. HWP 3.x 기록기가 없어 HWP3 편집은 조용히 HWP5를 만듭니다. HML 원본이 아니면 HML 출력이 없습니다. 표 속성 JSON은 스키마 검사 없이 받아들여집니다. 렌더링에는 Skia 빌드와 내려받은 웹폰트가 필요합니다. 각 한계는 감추지 않고 `rules/`에 적었습니다.

## 4. 다른 저장소에서 가져온 것

| 저장소 | 가져온 것 |
|---|---|
| `chrisryugj/kordoc` | 왜 → 무엇을 → 어떻게 문서 구성과, 보고서를 기계가 쓴 글로 읽히게 만드는 표현 목록(`rules/gongmunseo.md` 7절) |
| `jkf87/hwpx-skill` | 일곱 단계 항목 번호와 표기 표(날짜, 금액, 범위, 쌍점). 행정안전부 별지 제1호서식을 옮긴 내용 |
| `Canine89/hwpxskill`, `UpstageAI/korean-report-hwpx` | 공문서 서식 생성은 이미 붐비는 영역이고 둘 다 편집이 없어 쓰지 않았다는 확인 |
| `kangdacool/hwpx-editing-skill` | 편집은 성공 코드가 아니라 재읽기와 구조 검사로 증명해야 한다는 발상 |

코드는 아무것도 복사하지 않았습니다. 이 스킬의 모든 명령은 rhwp v0.9.0 바이너리로 실행했고, 나머지는 관례와 검증 사다리의 모양에만 영향을 줬습니다.

## 5. 이 조사로 정하지 못한 것

- `law.go.kr`이 이 환경에서 302로 넘겨서, 행정안전부 항목 번호 규칙은 원문이 아니라 2차 출처(`jkf87/hwpx-skill`에 재수록된 내용)로 기록했습니다.
- 별점은 인기 신호이고 품질 신호가 아닙니다. `hwplib`과 `hwp.js`는 별점 위치보다 오래되고 잘 시험된 라이브러리이며 JVM이나 브라우저에 넣을 때는 여전히 맞는 선택입니다. 셸 작업에 CLI가 필요해서 여기서만 아닙니다.
- rhwp의 조판이 한글 프로그램과 얼마나 같은지는 이 조사가 답하지 못합니다. 그 비교에는 한글 프로그램이 필요하고 여기에 설치돼 있지 않습니다.

## Sources

> 확인 2026-11-13. GitHub REST API와 rhwp v0.9.0 릴리스 자산을 기준으로 했습니다.

- GitHub REST API. `gh api repos/<owner>/<repo>`로 별점, 라이선스, `pushed_at`, `language`, `forks`, `description`을 2026-11-13에 읽음
- rhwp 릴리스 자산과 `SHA256SUMS.txt`: <https://github.com/edwardkim/rhwp/releases>
- crates.io rhwp 0.9.0 메타데이터: <https://crates.io/crates/rhwp>
- 소스 수준 확인: `edwardkim/rhwp`, `chrisryugj/kordoc`, `DoHyun468/claw-hwp`, `jkf87/hwpx-skill`, `treesoop/hwp-mcp`, `neolord0/hwplib`, `hahnlee/hwp.js`, `mete0r/pyhwp`의 blobless 클론
canvas-designanthropics/skillsCreate beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
docxanthropics/skillsUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
pdfanthropics/skillsUse this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
pptxanthropics/skillsUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill.Stars: 198kUpdated Claude CodeCodexVerifiedInstall