oma-hwp
Convert HWP / HWPX / HWPML files to Markdown using kordoc. Extracts text, headings, tables, lists, images, footnotes, and hyperlinks. Use for Korean word processor files (Hangul), government documents, and AI-ready data preparation.
npx skills add first-fluke/oh-my-agent --skill oma-hwp --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# HWP Skill - HWP / HWPX / HWPML to Markdown Conversion ## Scheduling ### Goal 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
- Scheduling
- Goal
- Intent signature
- When to use
- When NOT to use
- Expected inputs
- Expected outputs
- Dependencies
- Control-flow features
- Structural Flow
- Entry
- Scenes
- Transitions
- Failure and recovery
bunx kordoc@latest "{input_path}" -o "{output_path}"
fresh clone: run `bun install` in {skill_dir}/resources/ first (node_modules is gitignored)
bun "{skill_dir}/resources/flatten-tables.ts" "{output_path}"
bunx kordoc@latest "{input_pattern}" -d "{output_dir}"What does the oma-hwp skill do?
Convert HWP / HWPX / HWPML files to Markdown using kordoc. Extracts text, headings, tables, lists, images, footnotes, and hyperlinks. Use for Korean word processor files (Hangul), government documents, and AI-ready data preparation.
How do I install it?
Run `npx skills add first-fluke/oh-my-agent --skill oma-hwp --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From first-fluke/oh-my-agent, a repository with 1,204 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.