자동 저장소 셋업 (auto-repo-setup)
실행되지 않는 저장소를 진단·복구하고, 온보딩 문서와 안전한 Git 워크플로까지 표준화해 주는 스킬입니다.
개발·코딩중급★ 1,323⑂ 212AI 점수 9/10마지막 업데이트: 2026. 8. 8.
무엇을 해주나
- 환경 복구: AGENTS.md·CLAUDE.md·README·매니페스트·락파일을 순서대로 읽고 실제 스택을 파악한 뒤,
scripts/check_env.py로 읽기 전용 점검을 수행합니다. 누락된 도구체인만 최소 범위로 고칩니다. - 세션 동기화 루틴: "작업 전에 최신 코드 받아줘" 같은 요청을 안전하게 처리합니다. 작업 트리가 더러우면 자동 stash·rebase·force를 하지 않고 상태를 설명합니다.
- 훅 진단: SessionStart 출력이 중복될 때 프로젝트/로컬/유저/플러그인 등록을 모두 세어 원인을 먼저 밝힙니다.
- 저장소 인계 문서화: 온보딩 템플릿을 체크리스트로 사용해 실제 명령과 기대 출력이 담긴 핸드오프 문서를 만듭니다.
- Git 안전 게이트: 커밋·푸시·충돌 해결·히스토리 정리 전에 안전 규칙을 읽고, 공개 푸시나 force push는 명시적 승인을 요구합니다.
이런 분께 추천
- 새 노트북이나 새 팀원 환경에서 프로젝트가 도무지 안 돌아가는 개발자
- 온보딩 문서가 없거나 낡아서 매번 같은 질문을 받는 팀 리드
- Claude Code 훅 설정이 꼬여 시작 메시지가 여러 번 출력되는 사용자
- 실수로 커밋된 자격증명·PII를 정리해야 하는 오픈소스 배포 담당자
활용 예시
- "npm run dev가 안 됩니다" → 매니페스트와 락파일을 근거로 누락 런타임을 찾아내고, 수정 후 프로젝트의 실제 스모크 테스트를 다시 실행해 결과를 보고합니다.
- 신규 협업자 온보딩 → 기존 문서를 감사한 뒤 부족한 부분만 채워
ONBOARDING.md를 작성하고, 각 명령의 기대 출력과 실패 복구법을 함께 정리합니다. - 세션 시작 메시지 3번 중복 → 등록 개수를 실제로 세어 원인을 특정하고, 필요할 때만
--dry-run으로 미리보기 후 훅을 정리합니다.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 daymade/claude-code-skills 의 auto-repo-setup 폴더를 내 ~/.claude/skills/auto-repo-setup/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/daymade/claude-code-skills.git && mkdir -p ~/.claude/skills && cp -r claude-code-skills/auto-repo-setup ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 엽니다.
- 저장소를 내려받습니다:
git clone https://github.com/daymade/claude-code-skills.git - 스킬 폴더를 만듭니다:
mkdir -p ~/.claude/skills - 스킬을 복사합니다:
cp -r claude-code-skills/auto-repo-setup ~/.claude/skills/ references/,scripts/하위 파일까지 함께 복사되었는지 확인합니다.- Claude Code를 다시 시작한 뒤 "이 저장소가 실행되지 않아요, 셋업을 진단해줘"처럼 요청하면 스킬이 활성화됩니다.
- 훅 설치나 히스토리 정리 기능은 반드시
--dry-run미리보기 결과를 확인한 뒤 승인하세요.
GitHub에서 원본 보기 ↗라이선스: MIT