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 에이전트가 공문·보고서를 서식 그대로 작성하게 만드는 실전 경로입니다.
이 사례가 한국 1인 메이커 씬에 주는 의미:
AI 에이전트 시대에 “스킬”이라는 새 제품 형태가 생겼습니다. 앱도 SaaS도 아니고, AI가 특정 작업을 할 수 있게 해주는 능력 묶음입니다. 도메인 지식이 있는 사람이 만들기 좋은 형태이고, 진입 비용도 낮습니다.
같은 결의 한국 HWP·AI 에이전트 프로젝트 (우리 디스커버 등록):
- kordoc (문서 파싱·MCP)
- hwp-mcp (HWP MCP 서버)
- rhwp (HWP 뷰어·에디터)
- 모두의 AI cowork-plugins (한국 실무 플러그인 마켓)
정직하게 볼 지점:
대상이 HWPX(XML)이지 구형 HWP(바이너리)가 아닙니다. 실무에서 도는 문서에는 아직 .hwp가 많아, 먼저 한글에서 HWPX로 저장하는 단계가 앞에 붙습니다. 그 변환에서 이미 서식이 조금 달라질 수 있습니다.
그리고 AI가 XML을 직접 고치는 방식이라 실패하면 문서가 아예 열리지 않을 수 있습니다. 원본 사본을 두고 작업하는 것이 선택이 아니라 전제입니다.
타겟 사용자:
- AI로 공문·보고서를 서식 그대로 작성하려는 실무자
- HWPX를 프로그램으로 편집해야 하는 개발자
- Claude Code·Cursor에 한국 문서 능력을 붙이려는 메이커
- OWPML 구조를 배우려는 개발자
자주 묻는 질문
hwpxskill (Canine89), 어떤 서비스인가요?
hwpxskill은 한컴오피스 HWPX 문서를 AI 코딩 에이전트에서 다룰 수 있게 해주는 스킬입니다. 서식 보존이 중요한 편집에서 OWPML 표준 XML을 직접 다루는 방식을 택해, 기존 문서의 서식·구조를 거의 그대로 유지하면서 내용만 교체할 수 있습니다. 2026년 2월 시작해 2026년 8월 기준 스타 284개·포크 83개입니다.
hwpxskill (Canine89), 누가 만들었나요?
hwpxskill은 한컴오피스 HWPX 문서를 AI 코딩 에이전트에서 다룰 수 있게 해주는 스킬입니다. 한국 인디 메이커 생태계의 한글문서 사례로 Dreamboat 디스커버에 수록돼 있습니다.
hwpxskill (Canine89), 어떤 사람에게 추천되나요?
hwpxskill (Canine89) — AI로 공문·보고서를 서식 그대로 작성하려는 실무자, HWPX를 프로그램으로 편집해야 하는 개발자, Claude Code·Cursor에 한국 문서 능력을 붙이려는 메이커, OWPML 구조를 배우려는 개발자에게 맞습니다.
hwpxskill (Canine89), 어디서 사용할 수 있나요?
hwpxskill (Canine89) 공식 사이트는 github.com/Canine89/hwpxskill 이며, 여기서 바로 이용할 수 있습니다. Dreamboat 디스커버에서는 이 서비스가 무엇이고 누구에게 맞는지, 비슷한 한국 인디 메이커 서비스는 무엇이 있는지 함께 정리해 두었습니다.
