클로드스킬마트스킬 둘러보기스킬이 뭐예요?
 
← 목록으로

Claude Code 저장소 컨벤션 가이드

Claude Code CLI 코드베이스의 아키텍처·네이밍·툴/커맨드 작성 규칙을 Claude에게 주입하는 레퍼런스 스킬입니다.

개발·코딩고급★ 3,213⑂ 3,644AI 점수 6/10마지막 업데이트: 2026. 4. 22.

무엇을 해주나

Claude Code CLI(TypeScript, 약 1,900 파일 / 51만 줄) 저장소를 다룰 때 필요한 배경 지식을 한 파일에 정리한 참조형 스킬입니다.

  • src/ 하위 30여 개 디렉터리의 역할(commands, tools, components, services, coordinator, memdir 등)을 표로 제공
  • main.tsx → entrypoints/init.ts → entrypoints/cli.tsx 순의 초기화 시퀀스와 핵심 파일(QueryEngine.ts, Tool.ts, tools.ts) 설명
  • buildTool() 기반 툴 정의 템플릿, PromptCommand / LocalCommand / LocalJSXCommand 커맨드 3종 패턴 예시 코드
  • 권한 모드(default / plan / bypassPermissions / auto)와 Bash(git *) 같은 와일드카드 규칙, checkPermissions() 구현 원칙
  • Ink + React UI 구조, AppState 상태 관리, bun:bundle 피처 플래그, 네이밍·임포트 컨벤션, 설정 파일 위치

이런 분께 추천

  • Claude Code CLI 또는 그 포크/유사 구조의 대형 TypeScript CLI를 직접 수정하는 개발자
  • Ink(React for CLI) + Bun + Zod 조합의 실전 아키텍처 사례를 학습하고 싶은 분
  • 에이전트 툴·슬래시 커맨드·권한 시스템을 설계하며 참고 템플릿이 필요한 분

활용 예시

  1. "새 슬래시 커맨드 /changelog를 추가해줘" → 스킬의 PromptCommand 패턴과 allowedTools 규칙을 따라 src/commands/ 파일과 commands.ts 등록까지 일관되게 생성.
  2. "파일을 삭제하는 툴을 만들어줘" → buildTool 템플릿 + checkPermissions()·isReadOnly() 구현을 빠뜨리지 않고 작성하고 Zod 스키마로 입력 검증.
  3. "실험 기능은 어떻게 감춰야 해?" → bun:bundle의 feature('PROACTIVE') 플래그나 환경변수 게이팅 방식을 근거와 함께 안내.

· · · 설치 가이드 · · ·

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

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

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

직접 명령으로 설치하기

git clone https://github.com/codeaashu/claude-code.git /tmp/cc-skill && mkdir -p ~/.claude/skills/claude-code-skill && cp /tmp/cc-skill/Skill.md ~/.claude/skills/claude-code-skill/SKILL.md

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

  1. 터미널을 엽니다.
  2. 저장소를 임시 폴더에 내려받습니다: git clone https://github.com/codeaashu/claude-code.git /tmp/cc-skill
  3. 스킬 폴더를 만듭니다: mkdir -p ~/.claude/skills/claude-code-skill
  4. 스킬 파일을 복사합니다: cp /tmp/cc-skill/Skill.md ~/.claude/skills/claude-code-skill/SKILL.md
  5. 파일 맨 위 --- 블록에 name과 description이 있는지 확인합니다(없으면 로드되지 않습니다).
  6. Claude Code를 재시작하고 /skills(또는 스킬 목록 명령)로 등록 여부를 확인합니다.
  7. 해당 코드베이스 작업 시 "저장소 컨벤션에 맞춰 새 툴을 추가해줘"처럼 요청하면 스킬이 참조됩니다.
GitHub에서 원본 보기 ↗라이선스: NOASSERTION