hwpxskill (Canine89)

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 구조를 배우려는 개발자