Chapter 15: 팀과 함께 쓰는 스킬 — 공유와 설치

김치 담그기의 비밀

한국에는 김장 문화가 있죠. 가을이 되면 온 동네가 모여서 김치를 담가요.

근데 진짜 맛있는 김치 레시피를 가진 분이 있다고 해봐요. 어머니에서 딸로, 대대로 내려온 비법 레시피. 이 레시피를 어떻게 공유하면 좋을까요?

방법 1: 뒷마당에서 큰 소리로 외친다. "재료는요~! 배추 10포기에~! 고춧가루는~!"

아무도 제대로 못 들어요. 바람에 날아가고, 순서도 뒤죽박죽이 되겠죠.

방법 2: 레시피를 깔끔하게 정리해서 카드에 적고, 필요한 사람에게 나눠준다.

이게 훨씬 낫죠? 받은 사람은 집에 가서 카드대로 따라하면 돼요.

AI 스킬 공유도 똑같아요. 잘 정리된 스킬을 쉽게 가져갈 수 있는 곳에 올려두면, 누구나 다운받아서 쓸 수 있어요.

그 "쉽게 가져갈 수 있는 곳"이 바로 GitHub이고, 오늘은 그 전체 과정을 배워볼 거예요.

스킬은 어디에 사는가?

먼저, 스킬이 여러분의 컴퓨터 어디에 있는지 알아야 해요.

Claude Code가 스킬을 찾는 장소는 정해져 있어요:

~/.claude/skills/

이 경로가 스킬의 "집"이에요.

경로 해석하기

~ = "내 홈 디렉토리" (Mac/Linux에서는 /Users/여러분이름/, Windows에서는 C:\Users\여러분이름\)
.claude = Claude 설정 폴더 (앞에 점이 있으면 "숨김 폴더"라는 뜻)
skills = 스킬 모음 폴더

즉, ~/.claude/skills/my-skill/SKILL.md 이런 식으로 스킬이 저장돼 있어요.

또한, 프로젝트 디렉토리 안에 .claude/skills/ 폴더를 만들어서 프로젝트 전용 스킬을 둘 수도 있어요. 이 경우 해당 프로젝트에서만 그 스킬이 활성화돼요.

글로벌 스킬: ~/.claude/skills/ → 어디서든 사용 가능
프로젝트 스킬: 프로젝트/.claude/skills/ → 해당 프로젝트에서만 사용

팀 전체가 공유하는 스킬은 보통 프로젝트 스킬로 두는 게 좋아요. 프로젝트 저장소에 포함시키면, 팀원 모두가 자동으로 같은 스킬을 갖게 되니까요.

내 스킬 공유하기 — 3단계

스킬을 다른 사람에게 공유하는 건, 솔직히 말해서... 엄청 간단해요.

복잡한 패키징 과정이나 빌드 도구가 필요 없어요. 스킬의 본체는 그냥 텍스트 파일이니까요.

1단계: GitHub에 저장소 만들기

GitHub.com에 가서 새 저장소(repository)를 만들어요.

GitHub.com에 로그인
오른쪽 위 "+" 버튼 → "New repository" 클릭
이름 입력 (예: my-awesome-skill)
"Public"으로 설정 (누구나 볼 수 있게)
"Create repository" 클릭

끝이에요. 저장소가 만들어졌어요.

2단계: 스킬 파일을 올리기

터미널에서 몇 줄만 입력하면 돼요:

# 스킬 폴더로 이동
cd my-awesome-skill

# Git 초기화 (처음 한 번만)
git init

# 파일 추가
git add .

# 커밋 (변경 기록 저장)
git commit -m "첫 번째 스킬 업로드"

# GitHub 저장소와 연결
git remote add origin https://github.com/내아이디/my-awesome-skill.git

# 올리기!
git push -u origin main

Git 명령어가 처음이라 무서울 수 있는데, 걱정 마세요. 이 6줄만 따라 치면 돼요. 한 번 해보면 "아, 별거 아니네" 하실 거예요.

Git이 처음이라면

Git은 "파일의 변경 기록을 저장해주는 도구"예요. 마치 문서 작업할 때 "버전 1", "버전 2", "최종", "진짜 최종" 이렇게 저장하는 것의 프로 버전이라고 생각하세요. Git 설치가 안 되어 있다면, git-scm.com에서 다운받을 수 있어요.

3단계: 주소 공유하기

GitHub에 올렸으면, 저장소 주소를 공유하면 끝이에요.

https://github.com/내아이디/my-awesome-skill

이 링크를 슬랙에 올리든, 이메일로 보내든, 카톡으로 보내든 — 받는 사람은 클릭 한 번으로 여러분의 스킬을 볼 수 있어요.

정말 이게 끝이에요?

네, 진짜 이게 끝이에요.

다른 프로그래밍 도구들은 패키지 매니저, 빌드 도구, 배포 파이프라인... 복잡한 것들이 많은데, AI 스킬은 텍스트 파일이니까 GitHub에 올리기만 하면 공유 완료예요.

이게 스킬 패키지의 아름다운 점이에요. 단순함.

다른 사람의 스킬 설치하기

이번엔 반대로, 다른 사람이 만든 스킬을 가져오는 방법이에요.

누군가가 "이 스킬 좋으니까 써봐"라며 GitHub 링크를 보내줬다고 해봐요.

방법 1: Git으로 클론하기 (추천)

# 글로벌 스킬로 설치
cd ~/.claude/skills/
git clone https://github.com/만든사람/awesome-skill.git

이게 끝이에요. git clone은 "저 저장소의 파일들을 그대로 다운받아" 라는 뜻이에요.

이 방법의 좋은 점? 나중에 스킬 만든 사람이 업데이트를 하면, 여러분도 쉽게 업데이트할 수 있어요:

# 업데이트 받기
cd ~/.claude/skills/awesome-skill
git pull

git pull — "최신 버전 당겨와" 한 줄이면 업데이트 완료.

방법 2: 수동 다운로드

Git이 어렵다면, GitHub에서 직접 다운로드할 수도 있어요.

GitHub 저장소 페이지로 이동
초록색 "Code" 버튼 클릭
"Download ZIP" 클릭
다운받은 ZIP 파일을 ~/.claude/skills/에 압축 해제

다만 이 방법은 나중에 업데이트를 받으려면 다시 다운로드해야 하니까, 가능하면 Git을 쓰는 게 좋아요.

방법 3: 프로젝트에 포함시키기

팀 프로젝트라면, 프로젝트 저장소 안에 직접 스킬을 넣는 것도 좋은 방법이에요.

# 프로젝트 루트에서
mkdir -p .claude/skills
cd .claude/skills
git clone https://github.com/만든사람/awesome-skill.git

이러면 팀원들이 프로젝트를 받을 때 스킬도 자동으로 따라와요. 별도 설치 과정 없이!

버전 관리: 왜 Git이 중요한가

스킬을 공유하는 데 Git이 꼭 필요한 건 아니에요. 카톡으로 파일을 보내도 되긴 해요.

근데 Git을 쓰면 차원이 다른 경험이 됩니다.

Git이 없으면 vs 있으면

Git 없이:
"스킬_최종.md"
"스킬_최종_수정.md"
"스킬_진짜최종.md"
"스킬_진짜최종_v2_이게진짜.md"
...아 어떤 게 최신이야?

Git 있으면:
변경 기록이 자동 저장. 누가 언제 뭘 바꿨는지 다 보여요. 실수로 망쳤으면? 이전 버전으로 돌아가면 돼요.

특히 팀으로 스킬을 관리할 때, Git은 필수예요.

변경 이력 추적: "지난주에 description 바꿨더니 이상해졌어" → Git 로그 보고 이전 버전으로 복구
충돌 해결: 두 사람이 동시에 같은 파일을 수정했을 때, Git이 알려줘요
브랜치: "새 기능 실험해볼게" → 따로 브랜치 만들어서 실험, 괜찮으면 합치기

여러 사람이 함께 스킬 개선하기

혼자 만든 스킬도 좋지만, 여러 사람이 함께 다듬으면 더 좋아져요.

챕터 3에서 오픈소스 이야기했죠? "한 사람이 풀면, 모두가 혜택을 받는다." 스킬도 마찬가지예요.

협업의 흐름

공유: 여러분이 스킬을 GitHub에 올린다
사용: 팀원 A가 써보고, 개선점을 발견한다
제안: 팀원 A가 수정사항을 Pull Request로 보낸다 (다음 챕터에서 자세히!)
검토: 여러분이 "오, 좋은 제안이네!" 하고 받아들인다
적용: 스킬이 더 좋아진다
반복: 더 많은 사람이 쓰고, 더 많은 개선이 일어난다

이 과정이 반복되면, 혼자 만들 때보다 훨씬 빠르게 품질이 올라가요.

실전 팁: 좋은 README 쓰기

다른 사람이 여러분의 스킬을 보고 "이게 뭐하는 건지, 어떻게 쓰는 건지" 바로 이해할 수 있게 README.md를 잘 써두세요.

좋은 README에 포함할 것:
- 이 스킬이 뭘 하는지 (한 문장 설명)
- 어떻게 설치하는지 (복붙 가능한 명령어)
- 사용 예시 (실제로 어떻게 쓰는지)
- 주의사항 (있다면)

README는 스킬의 "첫인상"이에요. 첫인상이 좋으면 사람들이 써볼 확률이 높아져요.

공유의 에티켓

마지막으로, 스킬을 공유하고 받을 때 알아두면 좋은 에티켓 몇 가지.

공유하는 사람으로서:

개인 정보(API 키, 비밀번호, 회사 내부 URL 등)가 포함되지 않았는지 확인하세요
하드코딩된 경로 (/Users/내이름/...) 대신, 범용적인 설명을 쓰세요
스킬이 어떤 환경(Mac? Windows? 특정 도구 필요?)에서 작동하는지 적어주세요
피드백을 환영한다는 걸 README에 적어두면 좋아요

받는 사람으로서:

남이 만든 스킬을 쓰기 전에, SKILL.md를 한 번 읽어보세요. 어떤 도구를 사용하는지, 어떤 권한이 필요한지 확인
문제가 있으면 GitHub Issue로 정중하게 알려주세요. 만든 사람도 사람이에요!
유용하게 썼다면, GitHub에서 Star를 눌러주세요. 만든 사람에게 큰 힘이 돼요

"좋은 스킬을 만들었다면 공유하고, 좋은 스킬을 발견했다면 감사하고, 더 좋게 만들 수 있다면 기여하세요."

다음 챕터에서는...

공유를 넘어, 이제 진짜 오픈소스 기여자가 되어봅시다.
Pull Request를 보내고, 피드백을 주고받고, 커뮤니티에 참여하는 법을 배워요.
챕터 3에서 꿈꿨던 "나도 오픈소스에 기여하는 사람"이 될 시간이에요!