hwp

Documentation Community

Skill notes

What this skill does

kordoc으로 .hwp / .hwpx / .hwpml 문서를 AI가 읽기 좋은 Markdown 또는 JSON으로 바꾸고, 필요하면 문서 비교, 양식 필드 추출, Markdown→HWPX 역변환까지 수행한다. 이 스킬의 기본 엔진은 항상 kordoc 이다. 문서 변환, 비교, 필드 추출, 역변환까지 같은 도구로 일관되게 처리한다. 스킬 라우팅 — 이 hwp 스킬은 조회/변환(read-only) 전용이다. HWP 바이너리 편집(본문 텍스트 삽입/삭제, 표 생성, 셀 수정, replace-all)은 rhwp-edit 스킬이,

When to use

"이 HWP 파일을 Markdown으로 바꿔줘" "공문서를 JSON 구조로 뽑아서 AI가 읽게 해줘" "두 버전 문서 차이점을 보고 싶어" "신청서 HWPX 안에 어떤 양식 필드가 있는지 뽑아줘" "AI가 만든 Markdown을 다시 HWPX로 저장해줘"

When not to use

OCR이 필수인데 OCR provider 연결이 전혀 없는 이미지 기반 PDF만 있는 경우 .docx, .xlsx, .pdf 만 다루더라도 문서 파싱 자체가 아니라 편집기 GUI 자동화가 필요한 경우 원본 프로그램의 실시간 UI 제어가 반드시 필요한 경우 본문 텍스트 직접 삽입·삭제·치환 또는 표 구조 변경 — rhwp-edit 스킬의 k-skill-rhwp CLI 를 사용한다. 페이지 SVG 렌더 디버깅·IR 덤프·ir-diff·썸네일 추출 — rhwp-advanced 스킬의 업스트림 rhwp CLI 를 사용한다.

Prerequisites

Node.js 18+ 출력 경로 쓰기 권한 kordoc과 pdfjs-dist를 같은 전역/로컬 환경에 설치했거나, 둘 다 포함된 npx --yes --package kordoc --package pdfjs-dist kordoc ... 실행 환경 현재 배포된 kordoc CLI는 시작 시 pdfjs-dist를 바로 로드하므로 PDF를 안 써도 함께 설치해야 한다

Inputs

원본 .hwp, .hwpx, .hwpml 파일 경로 또는 폴더/글롭 경로 원하는 결과 형태: markdown, json, hwpx 출력 파일/디렉터리 경로 페이지 범위 지정 여부 비교 / 양식 필드 추출 / 역변환 여부

Fluxly profile Runtime and permissions are inferred by Fluxly static checks, not author declarations or runtime test results.
Domain
Documentation
Author-declared agents
No explicit declaration found; this is not inferred or tested compatibility
Static check
94 / 100 · heuristic scan, not runtime safety proof
Runtime evidence
Not run; no isolated runtime test evidence is currently recorded
Author / version / license
@NomaDamas · MIT
Token usage
Lean
Setup complexity
Plug-and-play
External API key
Not required
Operating systems
macOS · Linux · Windows
Runtime requirements
Node.js
Detected file/system behavior
  • Read-only
  • Write / modify
Network behavior
Local-only
Install commands
None (reference only)

Heads up: Tool permissions are not declared; actual access depends on the runtime.

Output preview hwp.preview
# 2. Prepare a local project for Node API examples

mkdir -p ./kordoc-local && cd ./kordoc-local
npm init -y
npm install kordoc pdfjs-dist

Discussion

Powered by GitHub Discussions. Sign in with GitHub to comment, react, or subscribe.