목차 보기
글
AI 스킬

hwpx-editing — 한글 문서를 안 깨지게 편집하는 AI 스킬

2026.11.17·2분·OPENSEED

hwpx-editing은 에이전트가 한글(.hwpx) 문서를 편집할 때 파일이 깨지는 것을 막아 주는 AI 스킬입니다. 한글 .hwpx 파일은 XML을 묶은 압축 구조여서, 에이전트가 그냥 풀어 고치고 다시 묶으면 한글에서 열리지 않는 일이 생깁니다. 이 스킬은 에이전트가 지켜야 할 편집 규칙과 파이썬 검사 도구를 함께 줍니다.

들어가며.

#hwpx-editing은 무엇을 하나요?

한글 .hwpx 파일은 XML 파일 여러 개를 압축해 묶은 형식입니다. 에이전트가 이 파일을 직접 풀어서 고치고 다시 묶으면 한글 프로그램에서 열리지 않는 경우가 자주 발생합니다.

hwpx-editing 스킬은 그 문제를 막기 위한 편집 규칙과 파이썬 도구를 에이전트에게 줍니다. 문단·표·그림·수식·각주 고치기, 표를 엑셀로 내보내기, 차례 만들기, 레이아웃 점검, 편집 뒤 파일이 열리는지 확인하는 검사까지 지원합니다.

한글 문서를 에이전트에게 맡겨 자동으로 편집하고 싶은 분, 표가 많은 한글 파일을 엑셀로 뽑아야 하는 분, 편집 뒤 파일이 깨지는 문제를 겪은 분에게 유용합니다.

02

#무엇이 필요한가요?

이 스킬을 쓰기 전에 아래 항목을 미리 준비해야 합니다.

  • Python 3.10 이상과 lxml 라이브러리가 설치되어 있어야 합니다.
  • 표를 엑셀로 내보낼 때는 openpyxl도 따로 설치해야 합니다.
  • 레이아웃 점검과 .hwp 일괄 변환 기능을 쓰려면 Windows용 한글이 필요합니다.
  • 편집할 .hwpx 파일이 있어야 합니다. 옛 .hwp 파일은 먼저 .hwpx로 변환해야 합니다.

게시물에 적힌 환경은 Claude Code와 Codex입니다.

03

#어떻게 설치하나요?

OpenSeed AI 스킬 모음집 게시물에서 로그인한 뒤 ZIP 파일을 무료로 받습니다.

Claude Code 또는 Codex를 사용하는 경우, ZIP을 풀어 나온 폴더를 프로젝트 폴더나 스킬 폴더에 넣고 도구를 다시 시작합니다.

04

#어떻게 시키면 되나요?

스킬을 설치하고 나면 에이전트에게 아래처럼 말하면 됩니다. 프롬프트를 그대로 쓰거나 상황에 맞게 바꿔서 사용할 수 있습니다.

  • "이 hwpx 파일 3쪽 표의 숫자를 고쳐 줘"
  • "이 한글 문서의 표를 엑셀로 뽑아 줘"
  • "한글에서 안 열리는 이 hwpx 파일을 점검해 줘"

에이전트는 스킬의 편집 규칙에 따라 파일을 수정하고 작업 결과물을 돌려줍니다. 받을 수 있는 결과는 아래와 같습니다.

  • 한글에서 그대로 열리는 수정된 .hwpx 파일
  • 병합 셀이 있는 표를 옮긴 엑셀 파일
  • 레이아웃·글꼴 점검 결과
05

#ZIP에는 무엇이 들어 있나요?

ZIP 안에는 파일이 47개 들어 있고, 스킬 파일은 1개입니다. 스킬 폴더 경로는 hwpx-editing-skill/skills/hwpx-editing입니다.

폴더파일 수
hwpx-editing-skill/skills18
hwpx-editing-skill12
hwpx-editing-skill/corpus9
hwpx-editing-skill/docs5
hwpx-editing-skill/.claude-plugin1
hwpx-editing-skill/.claude1
hwpx-editing-skill/hooks1
정리.

#쓰기 전에 무엇을 확인해야 하나요?

TIP
이 게시물은 kangdacool 님이 공개한 오픈소스 프로젝트를 OpenSeed 운영자가 MIT 라이선스에 따라 옮겨 올린 사본입니다. 원작자가 직접 올린 게시물이 아니며, 원작자와 제휴하거나 보증받은 것도 아닙니다. 라이선스 파일과 출처·바뀐 점은 ZIP 안의 OPENSEED-NOTE.md에서 확인할 수 있습니다.
  • Python 3.10 이상과 lxml을 미리 설치해야 합니다.
  • 표를 엑셀로 내보낼 때는 openpyxl도 따로 설치해야 합니다.
  • 레이아웃 점검과 .hwp 일괄 변환은 Windows용 한글이 있어야 작동합니다.
  • 옛 .hwp 파일을 받으면 먼저 .hwpx로 변환한 뒤 스킬을 사용해야 합니다.
  • ZIP 안의 OPENSEED-NOTE.md에 라이선스, 출처, 바뀐 점이 적혀 있습니다. 사용 전에 먼저 읽어 보세요.
  • 최신 버전은 원작자 kangdacool 님의 깃허브에서 확인할 수 있습니다.

출처

광고

이 스킬은 OpenSeed AI 스킬 모음집에서 받을 수 있습니다.

OpenSeed AI 스킬 모음집 게시물에서 로그인 후 ZIP을 무료로 받을 수 있습니다. Claude Code 또는 Codex에 넣으면 바로 사용할 수 있습니다.

제출 전 근거·논리·리스크를 점검하는 의사결정 지원 서비스

OpenSeed 검토 시작 →

관련 AI 피드백 서비스.

AI 피드백
사업계획서 AI 추천 →
AI 피드백
사업계획서 피드백 →
AI 피드백
K-Startup 점검 →
RELATED · 관련 문서AI 스킬
claude-hud — 컨텍스트·사용량·진행 상황을 입력창 아래에 계속 보여줘요2026.11.17 · 2분
BACKLINKS · 이 문서를 가리키는 문서
claude-hud 스킬
← 위키 목록으로