doc-coauthoring — Claude Code 스킬

긴 문서를 사람과 협업해 작성·편집하는 Anthropic 공식 스킬. 문서화·기술 문서 작성 워크플로에 적합.

doc-coauthoring은 Anthropic이 공식 skills 저장소(anthropics/skills)에서 제공하는 Claude Code 스킬로, 긴 분량의 문서를 사람과 AI가 협업해 체계적으로 작성·편집하도록 안내합니다. 단순히 "글 써줘"라고 던지면 맥락이 빠지거나 톤이 안 맞아 결국 통째로 다시 쓰게 되는 문제를, 단계를 나눈 구조화된 워크플로로 해결합니다.

핵심은 3단계 진행입니다. (1) 컨텍스트 수집 — 배경 정보를 모으고 명확화 질문을 주고받아 사람과 Claude가 같은 이해를 공유합니다. (2) 구조화·다듬기 — 문서를 섹션 단위로 쪼개 질문·브레인스토밍·선택지 큐레이션을 거치며, 전체를 다시 출력하지 않고 필요한 부분만 외과적으로 수정(surgical edit)합니다. (3) 독자 검증 — 별도의 Claude 인스턴스(서브에이전트)를 실제 독자처럼 세워 문서를 읽혀 모호함·사각지대를 미리 잡아냅니다. 사용자는 문서를 직접 고치기보다 수정안에 피드백을 주고, Claude가 그 스타일 선호를 학습해 다음 섹션에 반영합니다.

주요 특징은 효율과 품질의 균형을 맞춘 단계별 가이드, 아티팩트 기반의 부분 편집, Slack·Teams·Google Drive 등에서 맥락을 끌어오는 통합 지원, 서브에이전트 독자 테스트, 그리고 원하면 단계를 건너뛰거나 자유 작성할 수 있는 사용자 재량입니다.

기술 문서, 제품/기능 사양, 제안서, 의사결정 문서(RFC·design doc), 블로그 장문 등 "구조가 필요한 긴 글"을 쓰는 사람에게 적합합니다. 빠른 초안보다 독자에게 실제로 통하는 문서를 만드는 데 무게를 둡니다. 세부 동작과 최신 사용법은 공식 SKILL.md 확인을 권장합니다.

언제 쓰나

기술 문서·제품 사양·제안서·RFC·의사결정 문서·장문 블로그처럼 구조가 필요한 긴 글을 작성하거나 대대적으로 개편할 때 쓰기 좋습니다. 한 번에 완성하기보다 맥락을 정리해 섹션별로 다듬고, 발행 전에 독자 관점 검증까지 거치고 싶을 때 특히 유용합니다. 반대로 한두 문장 메모나 간단한 코멘트 작성에는 과합니다.

설치

git clone https://github.com/anthropics/skills 후 skills/doc-coauthoring 를 .claude/skills/ 로 복사. 또는 /plugin 공식 마켓플레이스에서 설치.

공식 anthropics/skills 저장소를 clone해 skills/doc-coauthoring 디렉터리를 프로젝트나 사용자 홈의 .claude/skills/ 아래로 복사하면 됩니다. 또는 Claude Code의 /plugin 공식 마켓플레이스에서 설치할 수 있습니다. 설치 후 Claude Code가 스킬 목록에서 인식하는지 확인하세요. 별도 API 키나 외부 서비스 토큰은 필요 없으며, 독자 검증 단계의 서브에이전트 기능은 사용 환경(클라이언트)이 지원할 때만 동작합니다. 정확한 경로·설치 방식은 저장소 최신 README와 SKILL.md를 확인하길 권장합니다.

보안 주의

별도의 비밀키나 결제·삭제 권한을 요구하지 않는 작성 보조 스킬입니다. 다만 워크플로 특성상 작성 대상 문서와 Slack·Teams·Google Drive 등 외부 소스에서 끌어온 컨텍스트가 모델에 전달되므로, 사내 기밀·개인정보·미공개 정보가 포함되지 않도록 입력 전에 점검하세요. 외부 문서를 가져올 때는 그 안에 숨은 지시문이 모델 동작을 바꾸는 프롬프트 인젝션 위험이 있으니, 신뢰할 수 없는 출처의 내용은 그대로 따르지 말고 검토하세요. 통합 연동을 쓸 경우 해당 플랫폼의 접근 권한 범위를 최소로 유지하길 권장합니다.

자주 묻는 질문

doc-coauthoring는 글을 자동으로 다 써주나요?

완전 자동 생성이 아니라 사람과의 협업을 전제로 합니다. 맥락 수집·섹션별 다듬기·독자 검증의 3단계로 진행하며, 사용자는 수정안에 피드백을 주고 Claude가 그 스타일을 학습해 반영합니다. 원하면 단계를 건너뛰고 자유롭게 쓸 수도 있습니다.

어떤 종류의 문서에 적합한가요?

기술 문서, 제품·기능 사양, 제안서, RFC·design doc 같은 의사결정 문서, 장문 블로그처럼 구조가 필요한 긴 글에 적합합니다. 한두 문장 메모나 간단한 수정에는 과한 도구입니다.

독자 검증 단계는 무엇인가요?

발행 전에 별도의 Claude 인스턴스(서브에이전트)를 실제 독자처럼 세워 문서를 읽히고, 모호하거나 빠진 부분을 찾아내는 단계입니다. 이 기능은 사용 환경이 서브에이전트를 지원할 때 동작합니다.