docx — Claude Code 스킬

Word(.docx) 문서를 ZIP/XML 구조로 다루는 Anthropic 공식 스킬. 목차, 머리글/바닥글, 이미지 삽입, 변경 내용 추적(tracked changes), 찾기-바꾸기 등을 지원한다.

docx는 Anthropic이 공식 배포하는 Claude Code용 문서 처리 스킬로, Microsoft Word(.docx) 파일을 ZIP/XML 구조 수준에서 직접 다룰 수 있게 해줍니다. .docx는 사실상 여러 XML 파트(document.xml, styles.xml, header/footer 등)와 미디어 리소스가 묶인 ZIP 컨테이너인데, 이 스킬은 그 내부 구조를 이해하고 안전하게 조작하는 방법과 도구 사용법을 Claude에게 제공합니다. 덕분에 사람이 워드를 열어 수작업하던 반복 편집을 자연어 지시만으로 자동화할 수 있습니다.

핵심으로 지원하는 작업은 다음과 같습니다. (1) 목차(TOC) 생성·갱신, (2) 머리글/바닥글 추가·수정, (3) 본문 내 이미지 삽입, (4) 문서 전체를 대상으로 한 찾기-바꾸기, (5) 변경 내용 추적(tracked changes) 형태의 수정 — 즉 검토자가 워드에서 "변경 내용 검토"로 보고 수락/거절할 수 있는 마크업으로 편집을 남기는 기능입니다. 단순 텍스트 치환을 넘어 스타일·서식·문서 구조를 보존하면서 편집한다는 점이 일반 텍스트 변환과의 차이입니다.

이런 작업이 잘 맞는 사용자는: 계약서·보고서·제안서 같은 표준 양식을 대량으로 채워야 하는 실무자, 템플릿 기반으로 여러 문서를 생성하는 운영/법무/HR 담당자, 리뷰 코멘트나 수정 제안을 tracked changes로 일괄 반영해야 하는 편집자, 그리고 문서 파이프라인을 자동화하려는 개발자입니다. 워드 문서를 사람이 열지 않고도 생성·수정·검토용으로 가공해야 할 때 특히 유용합니다.

이 스킬은 별도 외부 SaaS API 키 없이 로컬에서 .docx 파일을 다루는 흐름을 전제로 하며, pdf·xlsx·pptx 등 다른 오피스 문서 스킬과 함께 "문서 스킬" 묶음으로 제공됩니다. 세부 동작과 한계는 출처 저장소의 공식 문서를 함께 확인하는 것을 권장합니다.

언제 쓰나

Word(.docx) 문서를 사람이 직접 열지 않고 자동으로 생성·수정·검토 가공해야 할 때 적합합니다. 예: 템플릿에 데이터를 채워 계약서/보고서/제안서를 대량 생성, 머리글·바닥글·목차 일괄 정비, 여러 문서에 동일한 찾기-바꾸기 적용, 리뷰 수정안을 변경 내용 추적(tracked changes)으로 남겨 검토자가 수락/거절하게 하기. 서식·스타일을 보존해야 하는 워드 편집 자동화 전반에 유용합니다.

설치

/plugin marketplace add anthropics/skills 후 /plugin install document-skills@anthropic-agent-skills

Anthropic 공식 스킬 마켓플레이스를 통해 설치하며, document-skills 플러그인에 pdf·xlsx·pptx와 함께 묶여 제공됩니다(설치 명령은 별도 표기). 로컬에서 .docx 파일을 ZIP/XML로 다루는 흐름이라 외부 SaaS API 키는 필요 없습니다. 다만 .docx 내부 XML을 직접 조작하므로 원본 파일은 반드시 백업하고, 결과는 실제 Word나 호환 뷰어에서 서식·목차·변경 내용 추적 표시가 의도대로 보이는지 검증하세요. 매크로(.docm), 복잡한 표/수식 등 일부 구조는 한계가 있을 수 있어 공식 문서 확인을 권장합니다.

보안 주의

이 스킬은 별도 비밀키나 외부 인증을 요구하지 않지만, 로컬 파일시스템의 .docx를 읽고 덮어씁니다. 따라서 처리 대상 폴더 접근 권한이 곧 데이터 접근 범위가 되며, 계약서·인사·재무 같은 민감 문서를 다룰 때 유출·과다 노출에 주의해야 합니다. 찾기-바꾸기·변경 내용 추적은 원본을 직접 수정하므로 잘못된 패턴이 다수 파일을 손상시킬 수 있어 백업과 결과 검증이 필수입니다. 또한 외부에서 받은 .docx에는 머리글/주석/숨김 텍스트 등에 악의적 지시(프롬프트 인젝션)나 추적용 메타데이터가 포함될 수 있으니, 신뢰할 수 없는 문서 내용을 그대로 실행 지시로 받아들이지 말고 검토 후 처리하세요.

자주 묻는 질문

docx 스킬로 변경 내용 추적(tracked changes)을 남길 수 있나요?

네. 워드의 '변경 내용 검토'에서 수락/거절할 수 있는 tracked changes 형태로 편집을 남기는 것을 지원합니다. 검토자가 어떤 수정이 가해졌는지 확인하고 선택적으로 반영할 수 있어, 편집·리뷰 워크플로에 유용합니다.

외부 API 키나 유료 서비스 가입이 필요한가요?

아니요. .docx를 ZIP/XML 구조로 로컬에서 직접 다루는 방식이라 별도의 외부 SaaS API 키는 필요하지 않습니다. 다만 로컬 파일을 읽고 덮어쓰므로 파일 접근 권한과 백업에 유의하세요.

PDF나 엑셀, 파워포인트도 같은 방식으로 다룰 수 있나요?

docx는 Word 전용입니다. 동일한 Anthropic 문서 스킬 묶음에 pdf, xlsx(엑셀), pptx(파워포인트) 스킬이 함께 제공되므로 형식에 맞는 스킬을 사용하세요. 자세한 기능과 한계는 공식 문서 확인을 권장합니다.