Claude Code를 기반으로 하는 명령줄 인터페이스(Command Line)용 전문적인 Office 문서 생성 및 편집 워크플로입니다.

이 저장소는 Claude 데스크톱에서 사용되는 것과 동일한 Office 문서 조작 기술을 Claude Code(CLI 버전)에서 사용할 수 있도록 패키징했습니다. 터미널에서 Claude의 문서 생성 능력을 온전히 활용할 수 있으며, 스크립트, CI/CD 파이프라인 또는 자동화된 워크플로와 통합할 준비가 되어 있습니다.

업데이트 2026-04-01:
이 저장소는 Anthropic이 해당 기술들을 직접 공개하기 전에 게시되었습니다.
이 분야에 관심이 있는 분들께는 해당 기술들이 업데이트되고 있을 수 있으므로 공식 저장소를 확인해 보실 것을 권장합니다.

PowerPoint (PPTX)- 처음부터 또는 템플릿을 사용하여 프레젠테이션 생성, HTML-to-PPTX 변환 기능 포함
Word (DOCX)- 변경 내용 추적(Tracked changes), OOXML 조작, 레드라이닝(Redlining) 워크플로를 통한 문서 편집
Excel (XLSX)- 수식, 서식 지정 및 오류 없는 검증을 통한 재무 모델 구축
PDF- 양식 채우기, 문서 병합, 데이터 추출, 이미지로 변환

HTML-to-PPTX 변환- HTML/CSS로 슬라이드 디자인, 전체 서식을 유지하며 PPTX로 렌더링
템플릿 기반 생성- 슬라이드 재배치, JSON을 사용한 텍스트 교체, 서식 유지
시각적 검증 (Visual validation)- 텍스트 잘림 및 레이아웃 문제를 포착하기 위한 썸네일 그리드 생성
OOXML 편집- 정밀한 제어를 위한 직접적인 XML 조작

변경 내용 추적 (Tracked changes/Redlining)- 변경 내용 추적을 통한 전문적인 문서 편집
OOXML 조작- 주석 추가, 구조 수정, 서식 유지
텍스트 추출- 변경 내용 추적이 유지된 상태로 콘텐츠 내보내기

수식 기반 모델- 오류 제로 요건을 갖춘 작동 가능한 수식
전문적인 서식 지정- 색상으로 구분된 입력값/수식, 사용자 정의 숫자 형식
데이터 검증 (Data validation)- 텍스트로서의 연도 처리, '-'로 서식 지정된 0, 적절한 셀 스타일링

양식 채우기 (Form filling)- 프로그래밍 방식으로 채울 수 있는 PDF(Fillable PDFs) 작성
문서 병합- 여러 개의 PDF 결합
형식 변환- PPTX를 PDF로, PDF를 이미지로 변환
데이터 추출- PDF 양식 및 문서에서 정보 추출

Python 의존성 (dependencies)

venv/bin/pip install -r requirements.txt

Node.js 의존성 (dependencies) (html2pptx용)

...

Claude Code에게 만들고 싶은 것을 간단히 말하기만 하면 됩니다:

> 5개의 슬라이드로 구성된 분기별 영업 발표 자료를 만들어줘
> @input/slide_notes.txt를 기반으로 파워포인트 발표 자료를 만들어줘
> 이 Word 문서를 편집하고 변경 내용 추적을 추가해줘
...

Claude Code는 다음과 같이 동작합니다:

• 사용자의 작업에 적합한 스킬 (skill)이 존재하는지 확인
• 적절한 SKILL.md를 읽음
• 워크플로 (workflow) 실행 - 워크플로를 단계별로 실행
• 모든 출력물을 outputs/<document-name>/에 저장

모든 스크립트는 직접 실행할 수도 있습니다:

# PowerPoint 썸네일 그리드 생성
venv/bin/python public/pptx/scripts/thumbnail.py template.pptx outputs/review/thumbnails
# 슬라이드 재배치
...

public/
├── pptx/ # PowerPoint 워크플로 (workflows)
│ ├── SKILL.md # 주요 워크플로 (workflow) 문서
...

각 형식에는 워크플로 (workflow)를 정의하는 SKILL.md 파일이 있습니다. Claude Code는:

스킬 확인 (Checks for skills)

• 사용자 정의 코드를 작성하기 전에 스킬 (skill)이 존재하는지 확인

스킬 읽기 (Reads the skill)

• SKILL.md에서 전체 워크플로 (workflow)를 로드

워크플로 준수 (Follows the workflow)

• 각 단계를 정확하게 실행

출력물 검증 (Validates outputs)

• 검증 스크립트 실행 (OOXML 형식)

파일 정리 (Organizes files)

• 모든 출력물은 outputs/<document-name>/로 이동

# 1. 템플릿 텍스트 추출
venv/bin/python -m markitdown template.pptx
# 2. 썸네일 생성
...

Claude Code에게 발표 자료 생성을 요청하면 이 모든 단계를 자동으로 처리합니다.

• 대화형 문서 생성
• 생성 중 시각적 피드백 제공

자동화 (Automation)

• 월간 보고서 생성, 문서 배치 (batch) 처리

사용자 정의 워크플로 (Custom workflows)

• 다른 도구(데이터베이스, API, 스크립트)와 결합

서버 환경 (Server environments)

• 데스크톱 GUI 없이 헤드리스 (headless)로 실행

템플릿 반복 (Template iteration)

• 문서 템플릿 변경 사항을 신속하게 테스트

자동 보고 (Automated reporting)

• 데이터베이스 데이터를 활용하여 주간/월간 프레젠테이션 생성

배치 처리 (Batch processing)

• 100개의 HTML 페이지를 PPTX 슬라이드로 변환
• RAG (검색 증강 생성) 시스템에서 추출한 제품 데이터를 기반으로 영업용 덱 (sales decks) 생성

문서 파이프라인 (Document pipelines)

• 데이터 추출 → Excel 채우기 → PDF 생성 → 이메일 발송

API 통합 (API integration)

• Webhook을 통한 문서 생성 트리거
• 다른 작업을 위한 유사한 에이전트 (agents) 구축 방법 학습

시작하기 (Getting started): 리포지토리 컨벤션 (repository conventions)은 CLAUDE.md를 참조하세요.

워크플로 (Workflows): 각 public/*/SKILL.md 파일이 완전한 워크플로를 정의합니다.

스킬 시스템 (Skills system): skills-system.md에서 스킬 체크 (skills-check) 패턴을 설명합니다.

Claude Code 문서: docs.claude.com/claude-code

데스크톱 버전 (Desktop version): Claude를 사용하여 파일을 생성하고 편집하세요.

모든 생성된 파일은 outputs/<document-name>/로 이동합니다:

outputs/
├── quarterly-sales-report/
│ ├── final.pptx
...

이를 통해 작업 디렉토리를 깔끔하게 유지하고 자동화를 용이하게 만듭니다.

이 리포지토리의 대부분의 스크립트와 워크플로는 Claude (Anthropic의 AI 어시스턴트)로부터 직접 가져온 것이며, 여기에는 원문 그대로 포함되어 있습니다. 만약 Anthropic 측에서 이 리포지토리의 삭제를 원할 경우, 저에게 연락해 주시면 즉시 따르겠습니다.

이곳은 스킬 리포지토리입니다. 기능을 추가하려면:

• public/<format>/scripts/에 스크립트 추가
• 적절한 SKILL.md에 문서화
• 새로운 명령어를 포함하여 CLAUDE.md 업데이트
• 검증 (validation) 스크립트 통과 확인