hwp Skill (NomaDamas) for Claude Code: What It Does and How to Install It

Makes Claude read Korean HWP and HWPX documents and turn them into Markdown or JSON with the kordoc tool.

Installs: 10K; on skills.sh
Stars: 8.2K; on GitHub
Files: 2; besides SKILL.md
Updated: Nov 2026; last repo commit

This skill lets Claude open .hwp, .hwpx and .hwpml files, the formats used for Korean office and government documents. It converts them to Markdown or JSON, compares two versions, extracts form fields and can turn Markdown back into HWPX. It reads and converts only. Editing HWP files is left to another skill, rhwp-edit.

Its SKILL.md is a stub. The first step has Claude run an npx command that prints the live instructions, and the repo copy is instruction.md. It needs Node.js 18 or newer and uses npx to run kordoc and pdfjs-dist.

Good for

People who work with Korean government and office documents (HWP, HWPX)
Developers batch-converting a folder of HWP files for AI use
Anyone comparing two versions of an HWPX form or pulling out its fields

Install hwp

Claude Code

Copy this prompt.

Install the hwp skill in Claude Code. Run this command:

/plugin marketplace add NomaDamas/k-skill
/plugin install k-skill@k-skill

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js 18 or newer.

Pick one route. The plugin route installs the k-skill plugin, which covers the whole repo: 135 top-level skill folders (counted from the repo tree), with no hooks or MCP config files in the tree. The skills CLI and folder routes install only hwp. The skill needs Node.js 18 or newer and runs npx at use time, so there is no Claude app upload route.

From the project README. Source.

What's in the skill

When it loads

Use kordoc for agent-native HWP/HWPX document parsing, JSON extraction, diffing, form-field extraction, and Markdown→HWPX reverse conversion (read/convert only — for binary editing use rhwp-edit).

Sections in SKILL.md

Get the full instructions (required first step)
Hard rules even without the CLI

Key facts

Author: NomaDamas (repo owner; k-skill collection for Korean users)
License: MIT
Installs on skills.sh: 9,958 (Nov 2, 2026)
GitHub stars: 8,232 for the whole nomadamas/k-skill repo (Nov 2, 2026)
Last repo commit: Nov 1, 2026
Audits on skills.sh: Gen Agent Trust Hub: pass, Socket: pass, Snyk: pass
What it includes: 3 files: SKILL.md, instruction.md and skill.json (no scripts)
Needs: Node.js 18 or newer; kordoc and pdfjs-dist via npx
Part of: The k-skill plugin: 135 top-level skill folders in the repo tree

What it includes

SKILL.md tells Claude to run this first and follow its output
Fetches the current instructions from the k-skill npm package. The repo copy of those instructions is hwp/instruction.md.
Runs code · Bootstrap: npx -y @nomadamas/k-skill@0 instruct hwp
kordoc file.hwp -o file.md, or a whole folder with -d
Also --pages 1-3 for a page range. Run through npx with kordoc and pdfjs-dist.
Try: “Convert 보고서.hwp to Markdown”
Runs code · Convert to Markdown
kordoc file.hwpx --format json
Returns success, markdown, blocks and metadata.
Runs code · Extract JSON
extractFormFields() on parsed HWPX blocks
Uses a Node script with the kordoc library.
Runs code · Form field extraction
compare() returns added, removed and modified stats
Also a Node script with kordoc.
Runs code · Compare two versions
markdownToHwpx() writes a .hwpx file
The skill calls this reverse conversion. Binary editing of HWP files is left to the rhwp-edit skill.
Runs code · Markdown to HWPX
kordoc watch ./folder converts new documents as they arrive
Meant for a folder that keeps receiving documents.
Runs code · Watch a folder
Checks Markdown, JSON, batch, form and diff results after each run
A short checklist in instruction.md.
Read · Verify outputs

From the official docs

Permissions

High risk

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

Claude runs whatever the k-skill npm package prints
SKILL.md says to run npx -y @nomadamas/k-skill@0 instruct hwp and follow its output as the primary instructions. Claude therefore acts on text that comes from an npm package at run time, and the @0 tag floats across 0.x releases, so the instructions can change without any change to SKILL.md. Read the output before Claude acts on it. github.com
npx -y installs packages without asking
The bootstrap and the kordoc commands use npx -y or npx --yes with kordoc and pdfjs-dist. These download and run third-party code. A k-skill update command is also listed. github.com
The plugin route installs the whole k-skill set
The k-skill plugin in the repo tree has 135 top-level skill folders, including skills that cover other services. The skills CLI route can install just hwp. github.com
The k-skill CLI can send a usage event
docs/usage-analytics.md says the CLI can send a cli_invocation event to PostHog with a random local ID stored in ~/.config/k-skill/analytics-id, the command, skill name, CLI version, runtime mode and success. It says command arguments, input, file contents and credentials are not sent. Set KSKILL_ANALYTICS_DISABLED=1 to opt out. github.com
Hard rules in SKILL.md
SKILL.md says never to run payment, message delivery, final submission, cancellation or public posting without explicit approval, and never to handle plaintext credentials in chat or files. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	No read-only mode. The skill converts files and does not edit HWP binaries.
Talks to	npm registry (k-skill, kordoc and pdfjs-dist packages via npx). us.i.posthog.com (k-skill CLI usage event, unless you opt out)
Sign-in and keys	SKILL.md says never to ask for or store plaintext credentials. The hwp instructions name no account or key.
Scopes	Reads the HWP, HWPX and HWPML files you point it at Writes Markdown, JSON or HWPX files to paths you give Installs and runs npm packages through npx

Questions

What does the hwp skill do?

It makes Claude read Korean HWP, HWPX and HWPML documents using the kordoc tool. Claude can turn them into Markdown or JSON, compare two versions, pull out form fields and convert Markdown back to HWPX.

Can it edit HWP files?

No. The skill is for reading and converting. It sends text insertion, deletion, table changes and replace-all to a different skill, rhwp-edit, in the same repo.

How do I install it?

Use the install box at the top of this page. The repo README documents a Claude Code plugin that installs the whole k-skill set, and a skills CLI command that can install one skill. The skill also needs Node.js 18 or newer.

Why does it run an npx command before it starts?

SKILL.md is a short stub. Its first step has Claude run an npx command for the k-skill package, which prints the current instructions to follow. The same instructions are in the repo as hwp/instruction.md.

Does it send my documents anywhere?

The documented commands run kordoc on your machine against the paths you give, and the npx commands download packages from npm. Separately, docs/usage-analytics.md says the k-skill CLI can send a usage event to PostHog (random local ID, command, skill name, CLI version, runtime mode, success). It says command arguments, input and file contents are not sent, and KSKILL_ANALYTICS_DISABLED=1 opts out. Check what the k-skill CLI prints before Claude follows it.

Is it safe?

It runs npx with -y or --yes, which installs and runs npm packages without asking. The instructions it follows are fetched at run time. Use it on files you can afford to convert, and read the k-skill CLI output before Claude acts on it.

Are the instructions in Korean?

The instructions file instruction.md is written in Korean, and the README is too. SKILL.md itself is in English.

Information

updated Nov 2, 2026

Repository: nomadamas/k-skill
Folder: hwp

nomadamas/k-skill skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 5

k-skill README · github.com
k-skill marketplace.json · github.com
hwp SKILL.md · github.com
hwp instruction.md · github.com
k-skill CLI usage analytics · github.com