modu-ai/docx-generator
| 편집 가능한 워드(.docx) 문서를 만들어 드립니다 — 보고서, 계약서, 제안서, 공문서, 기획서를 한국형 디자인 톤으로 바로 쓸 수 있게 출력합니다. Claude 브랜드 톤 기반 모던 디자인 시스템과 한국 공문서 표준 양식을 함께 지원하며, 텍스트가 끝나면 AI 슬롭 검수로 자연스럽게 다듬을 수 있습니다. 보고서·문서를 워드(.docx) 파일로 만들 때는 Claude 기본 생성 대신 이 스킬을 사용하세요 (서식·디자인 보존).
npx skills add https://github.com/modu-ai/cowork-plugins --skill docx-generatorPython python-docx 라이브러리 기반 DOCX 생성 + Claude 브랜드 톤 모던 디자인 시스템.
한국 공문서·기업 보고서·계약서·제안서를 지원하며, 결과물이 "AI가 만든 듯한 진부한 디자인"이 아닌
프로페셔널한 시안으로 나오도록 색 팔레트·타이포 위계·간격·구조 패턴이 내장되어 있습니다.
워드, docx, Word 문서, 계약서, 공문서, 보고서 생성, 문서 편집, 기안문, 제안서, 공문, 협조문, 기획서
references/modern-design-system.md에 자세한 색·타이포·간격·헤딩 위계가 정의되어 있습니다.
| 역할 | 색 | hex | 사용처 |
|---|---|---|---|
| Primary | Anthropic Orange | #d97757 | 강조 헤딩·차트 highlight·구분선 |
| Secondary | Anthropic Blue | #6a9bcc | 보조 강조·인용·표 헤더 |
| Background | Light Beige | #faf9f5 | 본문 배경 (대신 #ffffff도 가능) |
| Surface | White | #ffffff | 표·코드 블록 배경 |
| Text Primary | Dark | #141413 | 본문 텍스트 (#000 대체) |
| Text Secondary | Mid Gray | #b0aea5 | 캡션·메타 정보 |
| Border | Light Gray | #e8e6dc | 표 보더·구분선 |
| 위계 | 한국 폰트 | 영문 폰트 | 사이즈 | weight |
|---|---|---|---|---|
| 본문 표지 | Pretendard | Inter | 28pt | Bold |
| H1 | Pretendard | Inter | 22pt | Bold |
| H2 | Pretendard | Inter | 18pt | SemiBold |
| H3 | Pretendard | Inter | 14pt | SemiBold |
| 본문 | Pretendard | Inter / Lora* | 11pt | Regular |
| 캡션 | Pretendard | Inter | 9pt | Regular |
| 코드/모노 | D2Coding | JetBrains Mono | 10pt | Regular |
\* Lora는 Anthropic 공식 본문 폰트. 인용·발췌 영역에 권장.
| 유형 | 디자인 톤 | 권장 팔레트 변형 |
|---|---|---|
| 한국 공문서 | 격식·전통 | Classic Mono (Dark + White만) |
| 기업 보고서 | 신뢰·데이터 중심 | Claude Classic (Orange + Beige + Dark) |
| 계약서 | 격식·중립 | Mono Strict (Dark + White) |
| 제안서 | 적극적·시각적 | Claude Coral (Crail + Pampas) |
| 기획서 | 창의·탐색 | Claude Blue (Blue + Beige) |
| 사업계획서 | 임팩트·자신감 | Claude Bold (Orange Highlight + Dark) |
문서 유형별 표준 구조 (references/modern-templates.md 참고):
공문서: 수신처·제목·내용(번호 매기기)·발신 기관명·담당자·연락처·날짜
계약서: 갑·을 표시·계약 목적·범위·기간·대금·지적재산권·비밀유지·해지·분쟁 해결·서명란
제안서: 표지·요약(Executive Summary)·현황·제안·기대효과·일정·예산·팀
보고서: 요약·배경·분석·결론·권고·부록
기획서: 배경·목표·전략·실행안·KPI·리스크
from docx import Document
from docx.shared import Pt, Cm, RGBColor
from docx.enum.text import WD_ALIGN_PARAGRAPH
from docx.oxml.ns import qn
from docx.oxml import OxmlElement
doc = Document()
# 페이지 설정 — A4 + 모던 여백
section = doc.sections[0]
section.page_height = Cm(29.7)
section.page_width = Cm(21.0)
section.top_margin = Cm(2.5)
section.bottom_margin = Cm(2.5)
section.left_margin = Cm(2.2)
section.right_margin = Cm(2.2)
# Claude 톤 색
CLAUDE_ORANGE = RGBColor(0xD9, 0x77, 0x57)
CLAUDE_DARK = RGBColor(0x14, 0x14, 0x13)
CLAUDE_MID = RGBColor(0xB0, 0xAE, 0xA5)
# H1 스타일
h1 = doc.styles['Heading 1']
h1.font.name = 'Pretendard'
h1.font.size = Pt(22)
h1.font.bold = True
h1.font.color.rgb = CLAUDE_DARK
# 강조 헤딩 (Primary Orange 사용)
title = doc.add_heading('2026 Q1 사업 보고서', level=0)
for run in title.runs:
run.font.color.rgb = CLAUDE_ORANGE
run.font.size = Pt(28)
전체 코드 패턴은 references/modern-templates.md 참고.
{변수명} → 실제 값)references/qa-checklist.md의 10단계를 자동/반자동 점검:
{변수명} 패턴 잔존 확인)10. AI 슬롭 표현 없음 (혁신적인·차세대·재정의하는 등 — moai-design:claude-design-slop-check 체이닝 권장)
보고서·제안서 첫 페이지에 1-page 요약 박스.
┌────────────────────────────────────────┐
│ Executive Summary │ ← Orange 강조선
│ ────────────────────────────────── │
│ [4-5줄 핵심 요약 — 본문보다 약간 큰 ]│
│ [폰트, 좌측 Orange 강조선 4pt] │
└────────────────────────────────────────┘
본문 중간의 인용 강조.
┃ "[인용문 — Lora 세리프 16pt 이탤릭]"
┃ — 출처 (Mid Gray, 11pt)
Anthropic Blue #6a9bcc 좌측 보더 4pt + Lora 이탤릭.
숫자 강조 영역.
[37%] [2.4배] [₩1.2억]
매출 증가 ROI 개선 예상 절감
숫자: Orange 36pt Bold · 라벨: Mid Gray 11pt.
좋은/나쁜·기존/제안 비교.
| 기준 | 기존 | 제안 |
| --- | --- | --- |
| Beige 헤더 | White cell | Orange tint |
본문 옆 메모·주석 박스 (Light Beige 배경).
섹션 사이 시각 구분.
─── ⬢ ────────────────────────────────
Section 2 — 시장 분석
Orange 작은 도형 + Mid Gray 가로선 + 섹션 번호.
.docx (Microsoft Word 2007+ 호환)한컴오피스 없는 환경에서 공문서가 필요한 경우 DOCX로 대체 가능합니다. 한컴 변환이 필요한 경우 moai-office:hwpx-writer 스킬 참조.
행정안전부 「공문서 작성 규정」 기준 양식을 준수합니다. 격식 공문서에서는 Orange·Blue 강조색을 사용하지 않고 Mono Strict (Dark + White만)로 작성합니다.
배포 시 폰트 내장 또는 PDF 변환을 권장합니다. Pretendard는 오픈소스라 임베드 자유. Lora는 Google Fonts 무료.
디지털 서명 필드 삽입을 지원합니다. Adobe Acrobat 호환 PDF 변환 후 전자서명을 권장합니다.
계약서 등 민감 문서는 비밀번호 보호 설정을 권장합니다. 문서 열기 암호와 편집 암호를 각각 설정할 수 있습니다.
| 상황 | 해결 방법 |
|---|---|
| 파일 생성 실패 | pip install python-docx 설치 후 재시도 |
| 색이 안 나옴 | RGBColor 사용 여부 확인 (docx.shared.RGBColor) |
| 폰트 깨짐 | 시스템에 Pretendard 설치 또는 PDF 변환 |
| Heading 스타일 안 먹힘 | doc.styles['Heading 1'] 직접 수정 |
| 한글 호환 | 굴림·맑은 고딕 fallback 권장 |
| 표 셀 색 안 바뀜 | _tc.get_or_add_tcPr() + OxmlElement('w:shd') 사용 |
| 페이지 번호 안 들어감 | 머리글·바닥글 영역에 field 객체 삽입 |
자세한 트러블슈팅·코드 예시는 references/modern-templates.md 참고.
문서 생성이 끝나면 산출된 .docx 파일을 다시 열어 플레이스홀더 잔존·페이지/분량 미달·한글 폰트·인코딩 깨짐·표 깨짐을 자체 검수하고, 문제가 있으면 자동 수정 후 재생성하며 최종 PASS/FAIL 결과를 보고합니다(검수 항목은 references/qa-checklist.md 참고).
| 스킬 | 사용 시점 |
|---|---|
| moai-office:pptx-designer | 발표용 슬라이드 생성 (같은 Claude 톤 디자인 시스템 공유) |
| moai-office:hwpx-writer | 한컴 한글 문서 생성 (HWPX) |
| moai-office:xlsx-creator | 엑셀 데이터 시트 |
| moai-office:pdf-writer | PDF 변환·다국어 PDF |
| moai-content:humanize-korean | 카피 AI 슬롭 자연화 |
| moai-core:ai-slop-reviewer | 텍스트 산출물 슬롭 검수 |
| moai-design:claude-design-slop-check | Claude Design 톤과 일관성 검수 |
references/modern-design-system.md — 색·타이포·간격 디자인 토큰 전문references/modern-templates.md — 6대 문서 유형별 모던 템플릿 구조references/qa-checklist.md — 10단계 검수 체크리스트references/document-generator.md — 한국 비즈니스 문서 생성 가이드 (기존 자료, 유지)Take modu-ai/docx-generator from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.
The instructions reference pip.
Without those the skill loads but fails at the first command.