Skill 범위이해하기 - 전역 vs 프로젝트 스킬
목차
스킬을 만들기 전에 반드시 결정해야 할 것이 있습니다.
"이 스킬을 어디에 저장할 것인가?"
스킬의 저장 위치에 따라 사용 범위가 완전히 달라집니다. 이 글에서는 전역 스킬과 프로젝트 스킬의 차이를 명확히 이해합니다.
스킬의 두 가지 범위
스킬 폴더가 두 군데 있던데, 뭐가 다른 거예요?
회사 조직도를 생각해봐. 본사 정책은 모든 지사에 적용되지만, 지사별 규정은 해당 지사에서만 적용되잖아?
아, 그러면 전역 스킬이 본사 정책이고, 프로젝트 스킬이 지사 규정인 거네요?
정확해! 전역 스킬은 어떤 프로젝트에서든 사용할 수 있고, 프로젝트 스킬은 해당 프로젝트에서만 사용할 수 있어.
전역 스킬 - 모든 프로젝트에서 사용 가능
위치: ~/.claude/skills/{스킬명}/SKILL.md
프로젝트 스킬 - 해당 프로젝트에서만 사용 가능
위치: {프로젝트}/.claude/skills/{스킬명}/SKILL.md
전역 스킬 상세
전역 스킬은 홈 디렉토리의 ~/.claude/skills/에 저장됩니다.
전역 스킬 경로: ~/.claude/skills/{스킬명}/SKILL.md
예시: ~/.claude/skills/blog-writer/SKILL.md
전역 스킬이 적합한 경우
💡 전역 스킬 사용 예시
- 개인 글쓰기 스타일 - 어떤 프로젝트든 동일한 톤 유지
- 코드 리뷰 기준 - 모든 프로젝트에 적용되는 리뷰 원칙
- 커밋 메시지 형식 - 회사 전체 표준 적용
- 번역 스킬 - 어디서든 같은 번역 품질
- 이메일 작성 - 업무 전반에 사용하는 이메일 템플릿
프로젝트에 무관하게 반복 사용하는 작업이라면 전역 스킬로 만드세요. 어디서든 바로 호출할 수 있습니다!
프로젝트 스킬 상세
프로젝트 스킬은 해당 프로젝트 폴더 내의 .claude/skills/에 저장됩니다.
프로젝트 스킬 경로: {프로젝트}/.claude/skills/{스킬명}/SKILL.md
예시: ~/my-app/.claude/skills/api-generator/SKILL.md
프로젝트 스킬이 적합한 경우
💡 프로젝트 스킬 사용 예시
- 프로젝트 전용 코드 스타일 - 이 프로젝트만의 컨벤션
- 특정 프레임워크 가이드 - Next.js, Django 등 프로젝트별 프레임워크
- 도메인 용어집 - 해당 서비스의 비즈니스 용어
- API 명세 기반 생성 - 프로젝트 API 구조에 맞춘 코드 생성
- 테스트 작성 규칙 - 프로젝트별 테스트 프레임워크 설정
프로젝트 스킬을 Git에 커밋해도 되나요?
오히려 커밋하는 걸 권장해! 팀원들도 같은 스킬을 사용할 수 있거든. 프로젝트 컨벤션을 AI도 따르게 만드는 거야.
전역 vs 프로젝트 비교표
| 구분 | 전역 스킬 | 프로젝트 스킬 |
|---|---|---|
| 위치 | ~/.claude/skills/ |
.claude/skills/ |
| 사용 범위 | 모든 프로젝트 | 해당 프로젝트만 |
| Git 공유 | 개인용 (공유 안 됨) | 팀 공유 가능 |
| 적합한 용도 | 개인 업무 스타일 | 프로젝트 컨벤션 |
| 우선순위 | 낮음 | 높음 (동일 이름 시) |
전역과 프로젝트에 같은 이름의 스킬이 있으면, 프로젝트 스킬이 우선 적용됩니다. 프로젝트별로 커스터마이징이 가능한 거죠!
어디에 만들지 결정하는 법
Q1. 이 스킬을 다른 프로젝트에서도 쓸 건가요?
→ Yes: 전역 스킬 / No: 프로젝트 스킬
Q2. 팀원들도 이 스킬을 사용해야 하나요?
→ Yes: 프로젝트 스킬 / No: 전역 스킬
Q3. 프로젝트별로 다르게 동작해야 하나요?
→ Yes: 프로젝트 스킬 / No: 전역 스킬
💡 판단 예시
"커밋 메시지 작성 스킬"
- 회사 전체 표준이 있다 → 전역 스킬
- 프로젝트마다 다른 형식 → 프로젝트 스킬
"API 엔드포인트 생성 스킬"
- 프로젝트 구조에 의존 → 프로젝트 스킬
전역 스킬 - 개인 업무 스타일, 어디서든 사용
프로젝트 스킬 - 프로젝트 컨벤션, 팀 공유 가능
우선순위 - 프로젝트 스킬 > 전역 스킬
판단 기준 - 재사용성, 팀 공유, 프로젝트 의존성
👉 SKILL.md 구조 이해하기 : 프론트매터와 본문, 제대로 작성하는 법
적절한 위치에 스킬을 배치하면 관리도 쉽고 활용도 높아집니다.
목적에 맞는 범위를 선택하세요! 📂
댓글
댓글 쓰기