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.md

View on GitHub
# HWP tooling survey, 2026-11-13

## 1. Why a survey at all

Korean word-processor files come in three shapes (.hwp 3.x, .hwp 5.x, .hwpx) and the ecosystem around them is split between parser libraries, format-specific generators, MCP wrappers, and full editors. Picking one is a decision that outlives the task, so every candidate that claims to read or write these files was listed, measured, and read at the source level before one was chosen.

> `last_verified_at: 2026-11-13`

Method: `gh api` for stars, licence, last push, and primary language; then a blobless clone of the top candidates and `git show HEAD:<path>` to read their actual entry points and skill documents rather than their READMEs.

## 2. The field

27 repositories, sorted by stars. "Last push" is the date the repository's default branch was last updated, not the release date.

| # | Repository | Stars | Licence | Last push | Lang | Shape | Judgement |
|---|---|---|---|---|---|---|---|
| 1 | [edwardkim/rhwp](https://github.com/edwardkim/rhwp) | 4119 | MIT | 2026-11-13 | Rust | viewer, editor, CLI, wasm | **chosen**: one binary covers read, edit, scaffold, convert, verify |
| 2 | [chrisryugj/kordoc](https://github.com/chrisryugj/kordoc) | 2990 | MIT | 2026-11-13 | TypeScript | document agent + 공문서 lint suite | conventions taken from its `gongmunseo` references |
| 3 | [hahnlee/hwp.js](https://github.com/hahnlee/hwp.js) | 1306 | Apache-2.0 | 2025-01-10 | TypeScript | HWP5 parser and viewer | read-only; last push 2025 |
| 4 | [neolord0/hwplib](https://github.com/neolord0/hwplib) | 587 | Apache-2.0 | 2026-09-11 | Java | HWP5 object model | JVM only, no CLI |
| 5 | [Canine89/hwpxskill](https://github.com/Canine89/hwpxskill) | 336 | none | 2026-06-27 | Python | HWPX generation skill | no licence, so not reusable |
| 6 | [jkf87/hwpx-skill](https://github.com/jkf87/hwpx-skill) | 309 | none | 2026-10-31 | Python | HWPX generation skill | no licence; its 공문서 rules page was cited as a secondary source |
| 7 | [mete0r/pyhwp](https://github.com/mete0r/pyhwp) | 303 | NOASSERTION | 2026-05-19 | Python | HWP5 parser | parser only |
| 8 | [jkf87/hwp-mcp](https://github.com/jkf87/hwp-mcp) | 270 | none | 2026-09-27 | Python | MCP wrapper | no licence |
| 9 | [postmelee/alhangeul-macos](https://github.com/postmelee/alhangeul-macos) | 246 | MIT | 2026-11-12 | Swift | macOS viewer and exporter | app-shaped, not scriptable from a shell task |
| 10 | [hahnlee/hwp-rs](https://github.com/hahnlee/hwp-rs) | 233 | Apache-2.0 | 2022-11-11 | Rust | parser and tools | abandoned since 2022 |
| 11 | [DoHyun468/claw-hwp](https://github.com/DoHyun468/claw-hwp) | 222 | MIT | 2026-11-12 | JavaScript | agent skill over a JS library | thinner command surface than rhwp |
| 12 | [Indosaram/hwpers](https://github.com/Indosaram/hwpers) | 191 | MIT | 2026-09-06 | Rust | HWP5 parser library | library only |
| 13 | [neolord0/hwpxlib](https://github.com/neolord0/hwpxlib) | 187 | Apache-2.0 | 2026-08-31 | Java | HWPX object model | JVM only |
| 14 | [msjang/pypandoc-hwpx](https://github.com/msjang/pypandoc-hwpx) | 187 | MIT | 2025-12-18 | Python | markdown/docx/html → hwpx | one direction only |
| 15 | [airmang/python-hwpx](https://github.com/airmang/python-hwpx) | 123 | Apache-2.0 | 2026-11-13 | Python | pure-Python HWPX read/edit/generate | credible HWPX-only alternative |
| 16 | [roboco-io/hwp2md](https://github.com/roboco-io/hwp2md) | 118 | MIT | 2026-10-11 | Go | HWP → Markdown | one direction only |
| 17 | [treesoop/hwp-mcp](https://github.com/treesoop/hwp-mcp) | 107 | MIT | 2026-11-01 | TypeScript | MCP read/write server | needs an MCP host; no shell path |
| 18 | [openhwp/openhwp](https://github.com/openhwp/openhwp) | 93 | MIT | 2025-12-12 | Rust | library, viewer, editor ambitions | not a working CLI |
| 19 | [kwakseongjae/auto-hwp](https://github.com/kwakseongjae/auto-hwp) | 42 | Apache-2.0 | 2026-11-13 | Rust | browser HWP editor | browser-shaped |
| 20 | [Dayoooun/hwpx-mcp](https://github.com/Dayoooun/hwpx-mcp) | 35 | MIT | 2026-11-05 | TypeScript | 125-tool MCP server | needs an MCP host |
| 21 | [volexity/hwp-extract](https://github.com/volexity/hwp-extract) | 29 | BSD-3-Clause | 2025-12-01 | Python | extraction for malware analysis | extraction only |
| 22 | [UpstageAI/korean-report-hwpx](https://github.com/UpstageAI/korean-report-hwpx) | 22 | MIT | 2026-11-10 | Python | 공문서 report generator | generator only, no edit |
| 23 | [kist-aix/hwpx](https://github.com/kist-aix/hwpx) | 20 | MIT | 2026-07-01 | Python | public-institution report skill | narrow template set |
| 24 | [ai-screams/HwpForge](https://github.com/ai-screams/HwpForge) | 20 | Apache-2.0 | 2026-11-13 | Rust | HWPX control library | HWPX only, young |
| 25 | [y5496694/narae_hangul](https://github.com/y5496694/narae_hangul) | 15 | MIT | 2026-10-28 | Python | CLI, skill, template package | small, unproven |
| 26 | [kangdacool/hwpx-editing-skill](https://github.com/kangdacool/hwpx-editing-skill) | 8 | MIT | 2026-10-12 | Python | HWPX edit verification skill | verification ideas only |
| 27 | [6aneffy/hwpx-kit](https://github.com/6aneffy/hwpx-kit) | 3 | Apache-2.0 | 2026-07-22 | Python | form fill, mail merge | too small to depend on |

## 3. Why rhwp

Four criteria decided it, in this order.

1. **One binary, every direction.** Read (`export-text`, `export-structure`, `export-tables`), edit (`replace-text`, `set-cell`, `fill-fields`, `insert-*`), create (`scaffold`), convert (`convert`, `export-hwpx`), and verify (`hwpx-roundtrip`, `hwp5-roundtrip`, `layout-anomaly`, `verify`). Every other candidate owns one arrow of that diagram. The two that come closest, `airmang/python-hwpx` and `ai-screams/HwpForge`, are HWPX-only, which excludes the .hwp files most Korean offices actually hold.
2. **A machine-readable contract.** `rhwp capabilities` prints the binary's own command and option inventory as JSON, so a probe can detect a too-old binary instead of failing on a missing flag halfway through an edit. No other candidate exposes this.
3. **It is maintained now.** Last push 2026-11-13, v0.9.0 published 2026-11-08, 361 forks. Three of the four most-starred alternatives were last touched in 2025 or earlier, and `hwp-rs` stopped in 2022.
4. **MIT, and an agent-facing guide written by the maintainer.** `mydocs/manual/rhwp_cli_skill_guide.md` and `agent_toolkit_cli.md` describe intended agent usage, which is the difference between a tool that happens to be scriptable and a tool designed to be driven.

What rhwp does not have, and what was checked: no HWP 3.x writer (editing an HWP3 file silently produces HWP5), no HML output for non-HML sources, table property JSON accepted without schema checking, and rendering needs a Skia build plus a downloaded webfont. Each of these is documented in `rules/` as a limit rather than papered over.

## 4. What was taken from the others

| Repository | Taken |
|---|---|
| `chrisryugj/kordoc` | the why → what → how document structure and the list of phrasing that makes a report read as machine-written (`rules/gongmunseo.md` §7) |
| `jkf87/hwpx-skill` | the seven-level item numbering and the notation table (dates, amounts, ranges, colons), restated from 행정안전부 별지 제1호서식 |
| `Canine89/hwpxskill`, `UpstageAI/korean-report-hwpx` | confirmation that 공문서 template generation is a crowded space; neither offers editing, so neither was used |
| `kangdacool/hwpx-editing-skill` | the idea that an edit must be verified against a re-read and a structural check, not just a success code |

Nothing was copied as code. Every command in this skill was executed against the rhwp v0.9.0 binary; the others informed conventions and the shape of the verification ladder.

## 5. What this survey could not settle

- `law.go.kr` returned a 302 redirect from this environment, so the 행정안전부 numbering rule is recorded as a secondary source (reproduced in `jkf87/hwpx-skill`) rather than the original document.
- Star counts are a popularity signal, not a quality one. `hwplib` and `hwp.js` are older and better tested than their star position suggests, and they remain the right choice for a JVM or browser embedding. They are wrong here only because a shell task needs a CLI.
- The survey says nothing about how faithfully rhwp renders compared with the Hangul application. That comparison needs the application, which is not installed.

## Sources

> Checked 2026-11-13 with the GitHub REST API and the rhwp v0.9.0 release assets.

- GitHub REST API via `gh api repos/<owner>/<repo>` for stars, licence, `pushed_at`, `language`, `forks`, `description`, read 2026-11-13
- rhwp release assets and `SHA256SUMS.txt`: <https://github.com/edwardkim/rhwp/releases>
- crates.io metadata for rhwp 0.9.0: <https://crates.io/crates/rhwp>
- Source-level reading: blobless clones of `edwardkim/rhwp`, `chrisryugj/kordoc`, `DoHyun468/claw-hwp`, `jkf87/hwpx-skill`, `treesoop/hwp-mcp`, `neolord0/hwplib`, `hahnlee/hwp.js`, `mete0r/pyhwp`
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