#hwpx-editing은 무엇을 하나요?
한글 .hwpx 파일은 XML 파일 여러 개를 압축해 묶은 형식입니다. 에이전트가 이 파일을 직접 풀어서 고치고 다시 묶으면 한글 프로그램에서 열리지 않는 경우가 자주 발생합니다.
hwpx-editing 스킬은 그 문제를 막기 위한 편집 규칙과 파이썬 도구를 에이전트에게 줍니다. 문단·표·그림·수식·각주 고치기, 표를 엑셀로 내보내기, 차례 만들기, 레이아웃 점검, 편집 뒤 파일이 열리는지 확인하는 검사까지 지원합니다.
한글 문서를 에이전트에게 맡겨 자동으로 편집하고 싶은 분, 표가 많은 한글 파일을 엑셀로 뽑아야 하는 분, 편집 뒤 파일이 깨지는 문제를 겪은 분에게 유용합니다.
#무엇이 필요한가요?
이 스킬을 쓰기 전에 아래 항목을 미리 준비해야 합니다.
- Python 3.10 이상과 lxml 라이브러리가 설치되어 있어야 합니다.
- 표를 엑셀로 내보낼 때는 openpyxl도 따로 설치해야 합니다.
- 레이아웃 점검과 .hwp 일괄 변환 기능을 쓰려면 Windows용 한글이 필요합니다.
- 편집할 .hwpx 파일이 있어야 합니다. 옛 .hwp 파일은 먼저 .hwpx로 변환해야 합니다.
게시물에 적힌 환경은 Claude Code와 Codex입니다.
#어떻게 설치하나요?
OpenSeed AI 스킬 모음집 게시물에서 로그인한 뒤 ZIP 파일을 무료로 받습니다.
Claude Code 또는 Codex를 사용하는 경우, ZIP을 풀어 나온 폴더를 프로젝트 폴더나 스킬 폴더에 넣고 도구를 다시 시작합니다.
#어떻게 시키면 되나요?
스킬을 설치하고 나면 에이전트에게 아래처럼 말하면 됩니다. 프롬프트를 그대로 쓰거나 상황에 맞게 바꿔서 사용할 수 있습니다.
- "이 hwpx 파일 3쪽 표의 숫자를 고쳐 줘"
- "이 한글 문서의 표를 엑셀로 뽑아 줘"
- "한글에서 안 열리는 이 hwpx 파일을 점검해 줘"
에이전트는 스킬의 편집 규칙에 따라 파일을 수정하고 작업 결과물을 돌려줍니다. 받을 수 있는 결과는 아래와 같습니다.
- 한글에서 그대로 열리는 수정된 .hwpx 파일
- 병합 셀이 있는 표를 옮긴 엑셀 파일
- 레이아웃·글꼴 점검 결과
#ZIP에는 무엇이 들어 있나요?
ZIP 안에는 파일이 47개 들어 있고, 스킬 파일은 1개입니다. 스킬 폴더 경로는 hwpx-editing-skill/skills/hwpx-editing입니다.
| 폴더 | 파일 수 |
|---|---|
| hwpx-editing-skill/skills | 18 |
| hwpx-editing-skill | 12 |
| hwpx-editing-skill/corpus | 9 |
| hwpx-editing-skill/docs | 5 |
| hwpx-editing-skill/.claude-plugin | 1 |
| hwpx-editing-skill/.claude | 1 |
| hwpx-editing-skill/hooks | 1 |
#쓰기 전에 무엇을 확인해야 하나요?
- Python 3.10 이상과 lxml을 미리 설치해야 합니다.
- 표를 엑셀로 내보낼 때는 openpyxl도 따로 설치해야 합니다.
- 레이아웃 점검과 .hwp 일괄 변환은 Windows용 한글이 있어야 작동합니다.
- 옛 .hwp 파일을 받으면 먼저 .hwpx로 변환한 뒤 스킬을 사용해야 합니다.
- ZIP 안의 OPENSEED-NOTE.md에 라이선스, 출처, 바뀐 점이 적혀 있습니다. 사용 전에 먼저 읽어 보세요.
- 최신 버전은 원작자 kangdacool 님의 깃허브에서 확인할 수 있습니다.
출처
- OpenSeed AI 스킬 모음집 — hwpx-editing — 한글 hwpx 파일 안 깨지게 편집 — OpenSeed, 2026-11-16 (확인: 2026-11-17)
- hwpx-editing 원본 저장소 — kangdacool, 2026-11-16 (확인: 2026-11-17)
이 스킬은 OpenSeed AI 스킬 모음집에서 받을 수 있습니다.
OpenSeed AI 스킬 모음집 게시물에서 로그인 후 ZIP을 무료로 받을 수 있습니다. Claude Code 또는 Codex에 넣으면 바로 사용할 수 있습니다.
제출 전 근거·논리·리스크를 점검하는 의사결정 지원 서비스
OpenSeed 검토 시작 →