Community코딩 & 개발github.com

sdkparkforbi/claude-skill-hwpx

파이썬으로 한글 문서(.hwpx)를 코드로 생성하는 Claude Code 스킬 — 표·셀병합·색·가로/세로, 한글 baking 포함

claude-skill-hwpx란 무엇인가요?

이 스킬은 Claude Code에서 파이썬을 사용하여 한글 문서(.hwpx)를 프로그래밍 방식으로 생성할 수 있게 해줍니다. 개발자는 표, 셀 병합, 색상, 가로/세로 방향, 그리고 한글 텍스트 내장(baking)과 같은 복잡한 문서 요소를 손쉽게 다룰 수 있습니다. 주로 Claude Code 환경에서 활용되며, 문서 생성 및 편집 작업을 자동화하고자 하는 개발자에게 유용합니다. 이 스킬은 SKILL.md 문서를 기반으로 동작하며, 파이썬 코드 조각과 함께 사용 방법을 상세히 설명합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add sdkparkforbi/claude-skill-hwpx

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

claude-skill-hwpx은(는) 무엇을 하나요?

파이썬으로 한글 문서(.hwpx)를 코드로 생성하는 Claude Code 스킬 — 표·셀병합·색·가로/세로, 한글 baking 포함

개요

이 스킬은 Claude Code에서 파이썬을 이용해 .hwpx 형식의 한글 문서를 생성할 수 있도록 합니다. 표, 셀 병합, 색상, 페이지 방향(가로/세로), 한글 글꼴 내장(baking) 등 고급 기능을 지원합니다.

설치

pip install hwpyname

또는 Claude Code 환경에서 자동으로 설치되도록 설정할 수 있습니다.

사용법

다음은 기본적인 .hwpx 문서 생성 예제입니다.

from hwpyname import Hwpyname

hwp = Hwpyname()
hwp.add_text("Hello, 한글!")
hwp.add_table(3, 4, merge_cells=[(0,0,0,2)], cell_colors=[(1,1,"#FFFF00")])
hwp.set_page_direction("landscape")
hwp.bake_fonts()
hwp.save("output.hwpx")

주요 기능

  • 표 생성 및 셀 병합: add_table(rows, cols, merge_cells, cell_colors)
  • 셀 색상 지정: RGB 또는 이름 기반 색상
  • 가로/세로 방향: set_page_direction("portrait" | "landscape")
  • 한글 글꼴 내장: bake_fonts()로 외부 의존성 없이 문서를 독립적으로 만듦
  • 텍스트 스타일링: 굵게, 기울임, 밑줄, 취소선 등

주의사항

  • OS에 관계없이 작동하나, 한글 글꼴 내장 시에는 한글 글꼴 파일이 필요할 수 있습니다.
  • Claude Code의 실행 환경에 따라 추가 패키지 설치가 필요할 수 있습니다.

기여

버그 리포트나 기능 제안은 GitHub 저장소에서 환영합니다.

관련 스킬