SKILL PACKAGE · 등록 안내

HWPX 스킬 등록 가이드

korean-doc-writer-pro와 new-hwpx-master, 두 스킬을 zip으로 묶어 전달하고 계정에 등록하는 절차를 정리했습니다.

2026. 8. 28. 스킬 2건 · .skill 패키지 2026. 9. 19. 구형 .hwp용 kordoc → 별도 페이지
⬇ 스킬 파일 바로 내려받기 korean-doc-writer-pro.skill new-hwpx-master.skill

01패키징된 두 스킬

각 스킬은 대화창에 첨부 파일로 전달됩니다. 둘은 서로 다른 역할을 맡고 있어 — 하나는 서식/표현 규칙, 다른 하나는 실제 파일 조작 절차 — 함께 등록해야 완전한 hwpx 작성이 가능합니다.

서식 · 표현 규칙

korean-doc-writer-pro

○○교육기관 공문서 표준을 따르는 작성 규칙 모음.

  • 레터헤드·수신/경유/제목 표 서식
  • 개조식 들여쓰기(1·가·1)·※ 4단계)
  • 굴림체 12pt 전체 통일 규칙
  • hp:tab 텍스트 소실 버그 회피법
파일명 · korean-doc-writer-pro.skill (약 5KB) ⬇ 내려받기
실행 · XML 조작

new-hwpx-master

hwpx 압축 해제부터 재패키징까지, 실제 파일을 다루는 코드 절차.

  • section0.xml / header.xml 구조 분석
  • 표 셀 채우기 · 문단 복제 헬퍼 함수
  • 들여쓰기(paraPr) 수치 조정표
  • 재패키징 + 검증(zip/XML) 절차
파일명 · new-hwpx-master.skill (약 7KB) ⬇ 내려받기
⚠ 함께 등록 권장 — korean-doc-writer-pro만 있으면 표준 기안문 신규 작성은 가능하지만, 기존 hwpx 양식을 열어 표를 채우거나 들여쓰기를 조정하는 작업은 new-hwpx-master 없이는 불안정합니다.

02등록 방법

전달된 두 파일 카드 또는 위 버튼으로 내려받은 뒤 시작합니다. 실제 화면은 3차시 강의 「SKILL 6종 맛보기 · 스킬 등록 3단계」에서 그대로 볼 수 있습니다.

  1. 대화창에서 파일 카드 확인

    korean-doc-writer-pro.skill, new-hwpx-master.skill 두 개의 다운로드 카드가 각각 전달됩니다.

  2. STEP 1 · '설정'으로 들어가기

    화면 왼쪽 아래 내 이름을 클릭 → 메뉴 맨 위 ⚙ 설정 클릭. 단축키 Ctrl + , 로도 열립니다.

  3. STEP 2 · '기능'에서 스킬 찾기

    왼쪽 메뉴에서 기능 클릭 → 오른쪽 화면을 맨 아래까지 스크롤 → 스킬 항목의 파란 글씨 Customize 클릭.

  4. STEP 3 · 스킬 파일 업로드

    오른쪽 위 + 클릭 → 스킬 만들기 위에 놓으면 옆으로 펼쳐지는 스킬 업로드 클릭 → 위에서 내려받은 .skill 파일 선택. 목록에 이름이 보이면 등록 성공입니다.

  5. 새 대화에서 등록 여부 확인

    새 세션을 시작해 사용 가능한 스킬 목록에 korean-doc-writer-pro, new-hwpx-master 두 이름이 뜨는지 직접 확인합니다. Claude는 저장 성공 여부를 알 수 없으므로 이 확인은 사용자 쪽에서 필요합니다.

  6. 두 스킬 모두 활성화

    hwpx 작성 요청 시 두 스킬이 함께 로드되도록 켜 둡니다. 하나만 켜면 앞서 설명한 기능 일부가 빠집니다.

03알아둘 점

기본 양식 파일 누락 — new-hwpx-master의 "표준 업무보고 양식" 기능은 원래 assets/업무보고_표준양식_260610.hwpx 첨부를 전제로 하지만, 이번 동기화본에는 해당 파일이 포함되어 있지 않습니다. 업무보고 양식이 필요하면 원본 hwpx 파일을 대화에 직접 첨부해 주세요.
파일명은 그대로 유지 — 등록 시 .skill 확장자와 파일명을 바꾸지 않는 것을 권장합니다. 이름이 스킬 식별자로 쓰입니다.

04어떤 상황에 어떤 스킬

상황필요한 스킬
○○교육기관 표준 기안문을 처음부터 새로 작성korean-doc-writer-pro 단독 가능
기존 hwpx 양식을 첨부해 내용만 채우기두 스킬 병행 필요
표가 포함된 문서(검토의견서 등) 작성두 스킬 병행 필요
탭 정렬·들여쓰기가 어긋난 hwpx 수정두 스킬 병행 필요
구형 .hwp 파일 읽기·내용 수정두 스킬로는 불가 → 아래 05 kordoc (데스크톱·클로드 코드)

05구형 .hwp까지 다루려면 — kordoc (별도 페이지)

위 두 스킬은 hwpx(XML) 전용입니다. 학교에 아직 많은 구형 .hwp(5.x 바이너리)를 클로드 데스크톱·클로드 코드에서 그대로 읽고 고치려면 공개 도구 kordoc을 한 번 붙여 둡니다. 설치 절차는 페이지를 따로 두었습니다.

웹(claude.ai)만 쓰신다면 — kordoc은 웹에서 못 쓰므로 한글에서 [다른 이름으로 저장] → hwpx 로 바꿔 첨부하면 됩니다.