Easy Hwp — Development skill for Claude Code

easy-hwp

**AI에게 한글 문서 작업을 부탁할 때 사용하는 HWP·HWPX 통합 스킬입니다.**

문서 읽기, 기존 파일 수정, 서식 채우기, 템플릿 재사용, PDF 미리보기를 하나의 `hwp` 스킬로 제공합니다. Codex, Claude Code, OpenClaw 등 `SKILL.md` 형식의 스킬을 사용하는 에이전트에 설치할 수 있습니다.

특정 사용자, 회사, 문서, 봇 계정에 종속되지 않습니다. 자신의 문서와 에이전트 환경에 맞춰 사용할 수 있습니다.

[최신 릴리스 받기](https://github.com/nathankim0/easy-hwp/releases/latest) · [패치노트](CHANGELOG.md)

목차

• 할 수 있는 일
• 설치 전 준비
• 설치
• 처음 사용하기
• 요청 예시
• 서식을 유지하는 방식
• PDF 내보내기
• 업데이트와 기존 스킬 정리
• 문제 해결
• 직접 스크립트 실행하기
• 개발과 검증
• 구성과 라이선스

할 수 있는 일

작업	사용 예시
문서 읽기·구조 분석	본문 추출, 표와 셀 병합 상태 확인
기존 문서 수정	날짜·이름·문구 변경, 담당 내용 일치 여부 확인
표 편집	셀 내용 수정, 행·열 추가, 셀 병합·분할, 정렬·테두리 조정
글자·문단 서식	글꼴·크기·굵기, 문단 간격, 줄 간격 조정
페이지 배치	제목이 페이지 끝에 혼자 남는 문제, 다음 페이지의 제목 간격 조정
문서 생성·서식 채우기	새 문서 작성, 기존 신청서의 대응하는 칸에 내용 입력
템플릿 재사용	프로젝트별 서식 저장, 목록 확인, 새 문서에 재사용
문서 요소 편집	이미지·도장·서명·차트·수식·머리말·꼬리말 관련 작업
PDF 미리보기	수정한 페이지의 줄바꿈·표·간격 확인

`.hwp`와 `.hwpx`는 내부 구조가 다릅니다. 파일에 맞는 편집 경로를 선택하며, **모든 기능이 두 형식에서 똑같이 지원되는 것은 아닙니다.** 세부 지원 범위는 [스킬 지침](plugins/easy-hwp/skills/hwp/SKILL.md)과 연결된 연산 문서에서 확인할 수 있습니다.

문서 비교, Markdown 변환, Windows 한컴 자동화 등은 필요에 따라 대체 도구를 사용합니다. 기본 설치에 모든 대체 도구를 설치할 필요는 없습니다.

설치 전 준비

항목	필요한 경우
스킬을 지원하는 AI 에이전트	AI에게 자연어로 문서 작업을 요청할 때
Git	Git으로 저장소를 복제하거나 업데이트할 때. ZIP 설치에는 불필요
Python 3.9 이상	설치 스크립트와 일부 문서 도구를 실행할 때
Node.js 18 이상	기본 문서 분석·편집 스크립트를 실행할 때
Node.js 22 이상 + Chrome/Chromium	포함된 PDF 미리보기 내보내기를 사용할 때

핵심 Node.js 라이브러리는 저장소에 포함되어 있어, **일반 사용자는 `npm install`을 실행할 필요가 없습니다.**

Windows의 Python 실행 명령이 `python3`이 아니라 `python` 또는 `py -3`이라면 아래 설치 명령에서 그 부분만 바꾸세요. 원본 한컴 앱을 통한 작업이나 별도 변환 도구에는 해당 도구의 설치·접근 권한이 추가로 필요합니다.

설치

Codex

터미널에서 다음 명령을 실행합니다.

git clone https://github.com/nathankim0/easy-hwp.git
cd easy-hwp
python3 scripts/install.py

기본 설치 위치는 `~/.c