클로드스킬마트스킬 둘러보기스킬이 뭐예요?
목록으로

DOCX 제작기 (docx-creator)

OpenXML 기반으로 마크다운을 실무용 Word(.docx) 문서로 변환하고, 중문 계약서급 조판 규칙과 시각 검증까지 강제하는 스킬입니다.

문서·오피스고급1,323212AI 점수 8/10마지막 업데이트: 2026. 8. 8.

무엇을 해주나

  • 마크다운 원고를 바로 납품 가능한 .docx로 변환하는 C# OpenXML 생성기(scripts/Program.cs)를 제공합니다.
  • minimax-skills:minimax-docx 엔진을 올바르게 구동하는 방법을 정리한 얇은 레이어입니다. 엔진 코드는 포함하지 않고, 엔진만으로는 해결되지 않는 실전 함정을 채워줍니다.
  • 핵심 규칙 4가지를 강제합니다.
    1. 정렬 계층화: 제목은 가운데, 조항 제목은 왼쪽, 甲方/乙方·서명란처럼 줄바꿈이 포함된 문단은 반드시 왼쪽 정렬(양쪽 정렬 시 글자 간격이 벌어져 깨짐).
    2. 목록 번호 1부터 재시작: 목록마다 별도 NumId + StartOverrideNumberingValue=1.
    3. CJK 폰트 이중 슬롯: RunFonts의 Ascii/HighAnsi/EastAsia를 모두 지정(본문 宋体, 제목 黑体).
    4. 페이지·표 기본값: A4 11906×16838 twips, 여백 1440, 표는 6개 테두리 전부 지정, 가운데 정렬 푸터 PAGE 필드.
  • 시각 검증 체인 강제: 생성 → XSD 검증 → soffice --headless PDF 변환 → pdftoppm -png → 모든 페이지 이미지 확인. macOS qlmanage 썸네일 사용은 금지(정작 중요한 버그를 숨김).
  • references/known_issues.md에 ISSUE-001~011로 증상·원인·해결·검증이 기록돼 있습니다.

이런 분께 추천

  • 중국어 계약서, 협의서, 공문, 오퍼레터, 노동계약서 등 형식이 엄격한 Word 문서를 자주 만드는 분
  • 마크다운으로 작업하고 결과물은 Word로 제출해야 하는 실무자
  • Word에서 열면 정렬이 깨지거나 목록 번호가 이어지는 문제로 고생한 경험이 있는 분
  • .NET 실행 환경과 LibreOffice 설치가 가능한 개발/운영 환경 사용자

활용 예시

  1. 노동계약서 작성: 조항을 마크다운으로 정리한 뒤 dotnet run --project _docxgen -- contract.md contract.docx로 생성. 甲方/乙方 정보 블록과 서명·날인란이 벌어지지 않은 상태로 출력됩니다.
  2. 마크다운 보고서 → Word 납품: 기존 report.md를 변환하고, PDF→PNG 변환 후 전체 페이지를 눈으로 확인해 표 테두리와 페이지 번호까지 검수합니다.
  3. 서식 커스터마이즈: Program.cs의 폰트 크기(본문 24 half-point = 12pt, H1 36 = 18pt)를 사내 규정에 맞게 수정해 회사 표준 템플릿 생성기로 재활용합니다.

PDF 결과물이 필요하면 이 스킬이 아니라 daymade-docs:pdf-creator를 사용하세요.

· · · 설치 가이드 · · ·

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 daymade/claude-code-skills 의 daymade-docs/docx-creator 폴더를 내 ~/.claude/skills/docx-creator/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/daymade/claude-code-skills.git && mkdir -p ~/.claude/skills && cp -r claude-code-skills/daymade-docs/docx-creator ~/.claude/skills/

제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 사전 준비물 확인
    • .NET SDK (dotnet --version)
    • LibreOffice (soffice --version) — 시각 검증용 PDF 변환
    • Poppler의 pdftoppm (macOS: brew install poppler)
    • 엔진 플러그인 minimax-skills:minimax-docx 설치 (보통 ~/.claude/plugins/marketplaces/minimax-skills/skills/minimax-docx/)
  2. 저장소 클론
    git clone https://github.com/daymade/claude-code-skills.git
    
  3. 스킬 폴더 복사
    mkdir -p ~/.claude/skills
    cp -r claude-code-skills/daymade-docs/docx-creator ~/.claude/skills/
    
  4. Claude Code 재시작 후 "Word 문서 만들어줘" / "계약서 docx로 작성해줘" 같이 요청하면 스킬이 자동 호출됩니다.
  5. 첫 실행 테스트: 작업 폴더에서 생성기를 스테이징하고 실행합니다.
    mkdir -p _docxgen && cp ~/.claude/skills/docx-creator/scripts/Program.cs \
       ~/.claude/skills/docx-creator/scripts/mmdocx-gen.csproj _docxgen/
    dotnet run --project _docxgen -- sample.md sample.docx
    
    첫 실행은 NuGet 패키지 복원으로 약 20초 걸립니다.
  6. 검증 체인 실행: soffice --headless --convert-to pdf --outdir /tmp/docxcheck sample.docxpdftoppm -png -r 100 /tmp/docxcheck/sample.pdf /tmp/docxcheck/page 후 모든 PNG를 확인합니다.
  7. 문제가 생기면 references/known_issues.mdscripts/README.md를 먼저 읽어보세요.