# hwpxskill (Canine89)

> AI 에이전트 HWPX 편집 스킬. 서식 그대로 문서를 편집하게 해 주며 OWPML XML을 직접 제어합니다. Claude Code·Cursor·Codex를 지원하고 스타는 284개입니다.

- 페이지: https://dreamboat.kr/discover/hwpxskill-ai-agent
- 공식 사이트: https://github.com/Canine89/hwpxskill
- 분야: 문서, AI
- 쓰는 환경: 라이브러리
- 상태: 운영 중
- 등재: 2026-08-10 · 마지막 갱신: 2026-10-23


## 소개

hwpxskill은 한컴오피스 HWPX 문서를 AI 코딩 에이전트에서 다룰 수 있게 해주는 스킬입니다. 서식 보존이 중요한 편집에서 OWPML 표준 XML을 직접 다루는 방식을 택해, 기존 문서의 서식·구조를 거의 그대로 유지하면서 내용만 교체할 수 있습니다. 2026년 2월 시작해 2026년 8월 기준 스타 284개·포크 83개입니다.

무엇을 할 수 있나:
원본 HWPX 파일을 넣으면 스타일·표 구조·셀 병합·여백까지 분석해 구조를 보존한 채 내용만 바꿉니다. 원본이 없으면 공문·보고서 같은 내장 템플릿으로 새 문서를 생성할 수도 있습니다. 작업 후 `page_guard.py`가 원본 대비 페이지 수 변화를 자동으로 잡아냅니다.

기술적으로 까다로운 지점:
- OWPML 표준 XML을 직접 다뤄 charPr·paraPr 단위로 서식 제어
- 일반 ZIP 재압축 대신 **원본 로컬 헤더와 압축 데이터를 보존**하고 변경된 `Contents/section0.xml`만 교체: 한컴이 파일을 손상으로 인식하지 않게 하기 위함
- `hwpx_slots.py`로 편집 가능한 문단·표 셀 슬롯을 먼저 추출한 뒤 채우는 흐름 지원
- 표·그림·텍스트상자 컨테이너 문단은 직접 수정하지 않음 (깨짐 방지)
- `hp:linesegarray` 줄 배치 캐시 제거로 한컴의 손상·변조 경고 가능성 축소
- `fix_namespaces.py`로 `ns0` 같은 자동 네임스페이스 프리픽스를 `hh/hc/hp/hs` 표준으로 정리

이 디테일이 말해주는 것:
문서를 “읽는” 것과 “원본을 깨지 않고 고치는” 것은 난이도가 완전히 다릅니다. 위 항목들은 전부 실제로 파일이 깨지거나 한컴이 경고를 띄우는 상황을 겪고 나서야 나오는 대응입니다. 실사용 없이는 나올 수 없는 수준의 구현입니다.

지원 환경:
Claude Code·Cursor·Codex CLI에서 모두 동작합니다. AI 에이전트가 공문·보고서를 서식 그대로 작성하게 만드는 실전 경로입니다.

스킬이라는 새 제품 형태:
AI 에이전트 시대에 “스킬”이라는 새 제품 형태가 생겼습니다. 앱도 SaaS도 아니고, AI가 특정 작업을 할 수 있게 해주는 능력 묶음입니다. 도메인 지식이 있는 사람이 만들기 좋은 형태이고, 진입 비용도 낮습니다.

같은 결의 한국 HWP·AI 에이전트 프로젝트:
- kordoc (문서 파싱·MCP)
- hwp-mcp (HWP MCP 서버)
- rhwp (HWP 뷰어·에디터)
- 모두의 AI cowork-plugins (한국 실무 플러그인 마켓)

그리고 AI가 XML을 직접 고치는 방식이라 **실패하면 문서가 아예 열리지 않을 수 있습니다.** 원본 사본을 두고 작업하는 것이 선택이 아니라 전제입니다.

타겟 사용자:
- AI로 공문·보고서를 서식 그대로 작성하려는 실무자
- HWPX를 프로그램으로 편집해야 하는 개발자
- Claude Code·Cursor에 한국 문서 능력을 붙이려는 메이커
- OWPML 구조를 배우려는 개발자

## 인용

이 소개는 Dreamboat(드림보트)이 공식 사이트를 직접 확인해 작성했습니다.
출처(https://dreamboat.kr/discover/hwpxskill-ai-agent)를 명시하면 인용 가능합니다. 서비스 자체의 권리는 각 제작자에게 있습니다.
전체 목록: https://dreamboat.kr/llms.txt · 전문: https://dreamboat.kr/llms-full.txt