클로드스킬마트스킬 둘러보기바로 쓰는 문장영상으로 배우기터미널 사용법스킬이 뭐예요?
목록으로

repo-docs — 저장소 문서 생성·동기화

코드베이스를 '실제 동작 하나'부터 설명하는 마크다운 가이드를 만들고, 코드 변경 후 문서를 최신 상태로 유지해 주는 스킬.

개발·코딩중급4566AI 점수 10/10마지막 업데이트: 2026. 7. 12.

무엇을 해주나

  • 저장소를 파일 트리 나열이 아니라 실제 동작 하나(요청·작업·데이터 흐름) 를 따라가는 방식으로 설명하는 문서 패키지를 생성합니다.
  • README.md, walkthroughs/one-real-run.md, code-map.md, modules/, references/source-evidence.md, glossary.md, change-log.md 구조로 산출물을 정리합니다.
  • 규모에 따라 Standard / Lite / Seed 세 가지 패키지 크기를 선택합니다.
  • 코드가 바뀌었을 때 문서를 무조건 고치지 않고, none / answer-only / foreground patch / background sync 중 하나로 판단하는 '동기화 게이트'를 거칩니다.
  • 모든 서술은 소스·테스트·설정 등 근거를 먼저 확인한 뒤 작성하고, 마지막에 scripts/validate_repo_docs.py로 구조·링크·근거 표를 검증합니다.
  • 루트 AGENTS.md / CLAUDE.md에 문서 라우팅 블록을 심어 이후 세션에서도 문서를 찾게 만듭니다.

이런 분께 추천

  • 새 팀원 온보딩 문서를 만들어야 하는 개발자·테크리드
  • 문서가 코드와 계속 어긋나는 오픈소스/사내 저장소 관리자
  • 처음 인수받은 레거시 프로젝트의 구조를 빠르게 파악해야 하는 분
  • 모노레포에서 특정 서브시스템만 범위를 정해 설명하고 싶은 분

활용 예시

  1. "이 저장소 repo-docs 만들어 줘" → 대표 동작 하나를 골라 워크스루를 쓰고, 코드 맵과 개념 모듈까지 생성합니다.
  2. 기능 PR을 머지한 뒤 "문서 동기화해 줘" → 오해를 만들 부분만 최소 패치하고 change-log.mdSynced through <sha>를 기록합니다.
  3. "인증 흐름이 어디서 처리돼?" 같은 질문 → 문서가 이미 정확하면 문서를 고치지 않고 답만 하고, 문서가 잘못된 모델을 심었다면 해당 페이지만 수정해 링크와 함께 답합니다.
  4. "생성된 repo-docs 전부 지워 줘" → 문서 패키지와 루트 포인터를 정리합니다.

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/YurunChen/repo-docs-skills/HEAD/docs/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

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

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

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

직접 명령으로 설치하기

git clone https://github.com/YurunChen/repo-docs-skills.git /tmp/repo-docs-skills && cp -r /tmp/repo-docs-skills/docs ~/.claude/skills/repo-docs

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

  1. 터미널을 엽니다.
  2. 스킬 폴더가 없으면 만듭니다: mkdir -p ~/.claude/skills
  3. 저장소를 내려받습니다: git clone https://github.com/YurunChen/repo-docs-skills.git /tmp/repo-docs-skills
  4. docs 폴더를 스킬로 복사합니다: cp -r /tmp/repo-docs-skills/docs ~/.claude/skills/repo-docs
  5. 중국어 오버레이도 쓰려면 repo-docs-zh 폴더가 있는지 확인해 함께 복사합니다.
  6. python3 --version으로 Python이 설치돼 있는지 확인합니다(검증 스크립트 실행에 필요).
  7. Claude Code를 재시작하고 대상 저장소 폴더에서 "repo-docs로 이 저장소 문서 만들어 줘"라고 요청합니다.
  8. 완료 후 python scripts/validate_repo_docs.py repo-docs --repo-root . 결과가 통과했는지 확인합니다.