Convert HWP / HWPX / HWPML files to Markdown using kordoc. Extracts text, headings, tables, lists, images, footnotes, and hyperlinks.
SkillScore77Maintained
Automatic
◆Doc Ops pack
Last verified 8/17/2026
What it changes
Passed 13 of 17 test cases with the skill, and 3 of 17 without it.
Without skill18%
With skill77%
Checks it passed that the model alone missed
Directs the user to run kordoc lint directly
Passes output directory -d /finance/md_exports/
Includes detected source format in the final report
and 17 more in the full report
14 fixed3 passed either way4 still failing1 broke
Pass-rate lift
+59 pp
Tokens
+84%
Agent turns
0%
Response time
-48%
Model gemini-3.6-flashMeasured 8/17/2026v317 of 22 cases passed with skill · 17 comparable
Tokens, turns and time describe resource use, not a dollar price.
See it in action
One of 14 test cases the skill fixed. Same model, same prompt, with and without the skill.
1 of 14
Prompt
I need to convert `/docs/spec.hwp` to `/docs/spec.md`. My custom renderer specifically requires preserving Hancom Private Use Area (PUA) glyphs and HTML table markup rather than GFM tables. What step should be omitted?
What was checked, without and with the skill
Checked
Without skill
With skill
Omits running the flatten-tables.ts post-processing script
Missed
Passed
case-13 · gemini-3.6-flash · 8/17/2026 · answers are capped and redacted
What's inside
The instructions your model reads when the skill loads.
Convert Korean HWP-family documents into readable Markdown or structured JSON while preserving document structure for LLM context, RAG, government-document review, or enterprise document processing.
Intent signature
User asks to convert, parse, read, extract, or transform .hwp, .hwpx, or .hwpml.
User mentions Korean word processor files, Hangul documents, government forms, or "한글 파일".
User needs headings, tables, nested tables, lists, images, footnotes, or hyperlinks extracted from HWP-family files.
When to use
Converting Korean HWP documents (.hwp, .hwpx, .hwpml) to Markdown
Preparing Korean government/enterprise documents for LLM context or RAG
Extracting structured content (tables, headings, lists, images) from HWP
User says "convert this HWP", "parse hwpx", "HWP to markdown", "한글 파일"
When NOT to use
PDF files -> use oma-pdf (OCR + Tagged PDF specialization)
XLSX / DOCX files -> out of scope; run bunx kordoc directly if needed (note: oma-docs is the documentation-drift skill, not a converter)
Generating or editing HWP documents -> out of scope (kordoc itself supports generate / fill / seal / patch / redact / lint / validate / render subcommands; run bunx kordoc@latest <subcommand> directly if needed)
Already-text files -> use Read tool directly
Expected inputs
input_path: .hwp, .hwpx, or .hwpml file path
output_path or output_dir: optional explicit output target
format: optional output format — markdown (default), json (structured AST), or chunks (RAG-oriented structural chunk JSON with heading breadcrumbs and standalone table chunks)
page_range: optional page or section range
kordoc_version: optional pinned kordoc version
Expected outputs
Markdown output next to the input file or in the requested directory
Optional JSON or RAG-chunks output when requested
Post-processed Markdown with flattened GFM tables and stripped Private Use Area glyphs by default
A short report with output path, detected source format, and conversion issues
Dependencies
bun and bunx
bunx kordoc@latest or configured pinned kordoc version