클로드 코드 스킬 설치법: 개인용과 프로젝트용

여러 프로젝트에서 혼자 쓰려면 ~/.claude/skills에, 현재 프로젝트에서 팀과 함께 쓰려면 .claude/skills에 넣어요. 팀 공유용은 저장소에도 포함해야 다른 사람이 받을 수 있어요.

스킬 여러 개와 에이전트·훅·MCP 설정 등을 배포할 때는 플러그인으로 묶을 수도 있어요. 처음 스킬 하나를 설치한다면 개인용과 프로젝트용 중 필요한 범위를 고르면 돼요.

압축 파일로 받았다면 먼저 압축을 풀어 내용을 확인해 주세요. SKILL.md가 있는 폴더를 선택한 skills 경로 아래로 옮겨요. 예를 들어 .claude/skills/my-skill/SKILL.md 형태예요.

참고 자료와 스크립트도 함께 옮겨야 해요. SKILL.md가 다른 파일을 상대 경로로 가리킬 수 있어서 폴더 안의 구조를 유지하는 편이 좋아요.

Claude Code는 일반적인 스킬 폴더의 변경을 감지해요. 새 스킬이 보이지 않거나 이번에 skills 폴더 자체를 처음 만들었다면 세션을 다시 시작해 보세요.

/ 메뉴에서 스킬 이름을 찾아보거나 사용할 수 있는 스킬을 나열해 달라고 요청해 보세요. 이름이 보이면 작은 예시 작업에 직접 호출해 봐요.

예를 들어 회의록 스킬이라면 짧은 메모로 결정 사항과 할 일을 정리하게 해 보세요. 이름이 목록에 뜨는지와 지침대로 결과가 나오는지는 각각 확인해야 해요.

파일 위치, SKILL.md 이름, 상단 YAML 형식부터 확인해 주세요. 폴더를 한 겹 더 감싼 채 복사했거나 파일 확장자가 .md.txt로 저장된 경우도 살펴봐요.

직접 이름을 지정하면 실행되는데 자동으로 선택되지 않는다면 description과 호출 설정을 확인해요. “코드를 잘 짠다” 대신 “React 컴포넌트를 새로 만들거나 수정할 때 사용한다”처럼 사용 상황을 적어 주세요.

이름을 지정해도 실행되지 않으면 오류 메시지를 함께 확인해요. 파일 경로뿐 아니라 조직 정책이나 도구 권한 때문에 제한됐을 수도 있어요.

설명이 비슷하면 의도하지 않은 스킬이 선택될 수 있어요. 각 스킬이 맡는 작업과 사용하지 않을 상황을 구분해 적고, 중요한 작업에서는 이름을 직접 지정해 보세요.

같은 이름을 개인용과 프로젝트용에 함께 두는 것도 피하는 편이 좋아요. Claude Code에서는 개인 스킬이 같은 이름의 프로젝트 스킬보다 우선해요. 팀 스킬을 시험할 때는 이름이나 위치를 구분해 주세요.

사용하지 않는 스킬은 별도로 보관하거나 호출 설정을 조정해 목록을 정리할 수 있어요.

프로젝트의 .claude/skills 폴더를 저장소에 포함하면 팀원이 프로젝트와 함께 받을 수 있어요. 필요한 프로그램, 환경 변수 이름, 실행 예시도 안내해 주세요. 비밀 키 자체를 파일에 넣지는 마세요.

구매한 스킬을 공유하려면 판매자가 정한 이용 범위를 확인해 주세요. 비공개 저장소라고 해서 팀 전체의 사용이나 재배포가 자동으로 허용되는 것은 아니에요.

평소 하던 일 중 결과를 쉽게 비교할 수 있는 작업을 골라 보세요. 문서 한 장 정리하기나 짧은 코드 리뷰처럼 입력이 작으면 설치와 실행 문제를 구분하기 쉬워요.

샘플이나 무료로 공개된 스킬로 형식을 익힐 수도 있어요. 실행 결과를 본 뒤 필요한 분야의 스킬을 살펴보면 어떤 설명과 예시가 있어야 하는지도 알 수 있어요.