# Kordoc Parse Document

> Use when converting Korean document files into readable text with `npx` and kordoc. Covers HWP, HWPX, and PDF parsing to Markdown or JSON, including metadata, outline, warnings, and page count. Trigger for requests such as reading a government document, extracting document contents, summarizing a Korean office file, or parsing a local .hwp/.hwpx/.pdf with `kordoc:parse_document`.

- **Type:** Skill
- **Install:** `agentstack add skill-composite-korean-skills-kordoc-parse-document`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [composite](https://agentstack.voostack.com/s/composite)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [composite](https://github.com/composite)
- **Source:** https://github.com/composite/korean-skills/tree/jumo/skills/kordoc-parse-document

## Install

```sh
agentstack add skill-composite-korean-skills-kordoc-parse-document
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# kordoc: parse_document

Use the public CLI first. This skill maps to the `parse_document` intent in `src/mcp.ts`, but without MCP.

## Input Requirements

- Require exactly one target document.
- Require the user to attach the document or provide a concrete local path.
- Accept only supported formats: `.hwp`, `.hwpx`, `.pdf`.
- Do not proceed if the document is missing or the path is ambiguous.

## Default Command

```bash
npm exec --yes --package=kordoc --package=pdfjs-dist -- \
  kordoc /abs/path/document.hwpx
```

Use JSON when the caller needs blocks or metadata:

```bash
npm exec --yes --package=kordoc --package=pdfjs-dist -- \
  kordoc /abs/path/document.hwpx --format json --silent
```

## Workflow

1. Resolve the target file to an absolute path.
2. Confirm the extension is `.hwp`, `.hwpx`, or `.pdf`.
3. Use plain CLI output for human reading.
4. Use `--format json` when the task needs `metadata`, `outline`, `warnings`, or `blocks`.
5. Summarize the parsed content instead of dumping the whole document unless the user asked for raw output.

## Guardrails

- Install `pdfjs-dist` alongside `kordoc`; the package may fail to load without it.
- Preserve warnings about image-based PDFs, skipped elements, or hidden text filtering.
- Do not claim OCR happened unless the execution path explicitly used an OCR-capable custom script.
- If the file is large, summarize key sections first.
- Refuse to continue when no supported document was provided.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [composite](https://github.com/composite)
- **Source:** [composite/korean-skills](https://github.com/composite/korean-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-composite-korean-skills-kordoc-parse-document
- Seller: https://agentstack.voostack.com/s/composite
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.