kordoclisted

# kordoc 문서 파싱 스킬 ## 개요 이 스킬은 한국 공공기관 및 업무 환경에서 주로 사용되는 HWP 5.x, HWPX 문서를 비롯해 PDF, XLSX, DOCX 파일을 Markdown 형식으로 변환해 줍니다. 또한 문서 양식의 빈칸을 자동으로 채워넣는 기능(Form Filler)을 제공하여 서식을 100% 보존한 채로 새로운 문서를 생성할 수 있습니다. ## 핵심 기능 및 에이전트 사용법 kordoc은 Node.js 기반 CLI 도구로 동작하며, 에이전트는 **`Bash` 도구**로 파서를 직접 실행합니다. CLI 진입점은 **이 스킬 디렉토리 기준 `scripts/kordoc/dist/cli.js`** 입니다. 설치 위치에 따라 실제 절대경로가 달라지므로(글로벌 설치는 `~/.claude/skills/kordoc/`, 프로젝트 설치는 `<프로젝트>/.claude/skills/kordoc/`), 아래 예시의 `$KORDOC`를 실제 경로로 바꿔 사용하세요. ```bash # macOS / Linux — 글로벌 설치 기준 KORDOC="$HOME/.claude/skills/kordoc/scripts/kordoc/dist/cli.js" ``` ```powershell # Windows PowerShell — 글로벌 설치 기준 $KORDOC = "$env:USERPROFILE\.claude\skills\kordoc\scripts\kordoc\dist\cli.js" ``` ### 1. 일반 문서 파싱 (Markdown 변환) 어떤 포맷이든 지정된 파일을 마크다운 형식으로 읽어옵니다. ```bash node "$KORDOC" <입력파일_절대경로> -o <출력파일_절대경로.md> ``` *Tip: `-o` 없이 실행하면 stdout으로 마크다운 결과가 바로 출력됩니다.* 주요 옵션: `-p, --pages <range>` (페이지·섹션 범위), `--format json` (구조화 출력), `--no-header-footer` (PDF 머리글·바닥글 제거), `--silent` (진행 메시지 숨김). ### 2. 양식 채우기 (Form Filler) 공문서 양식(HWPX 등)에 특정 값을 채워넣고 새로운 파일로 저장합니다. 인자는 **템플릿 하나**만 받고, 채울 값��� 출력 경로는 옵션으로 지정합니다. ```bash # key=value 쉼표 구분 node "$KORDOC" fill <원본양식.hwpx> -f '성명=홍길동,날짜=2026-04-26' -o <출력.hwpx> # JSON 파일로 값 전달 node "$KORDOC" fill <원본양식.hwpx> -j values.json -o <출력.hwpx> # 채우지 않고 서식의 빈칸 목록만 먼저 확인 node "$KORDOC" fill <원본양식.hwpx> --dry-run ``` 출력 포맷은 기본값이 `hwpx-preserve`(원본 스타일 보존)이며, `--format hwpx | markdown`으로 바꿀 수 있습니다. ### 3. 그 밖의 하위 명령