Skills 공유하기
Skills 공유하기 · 4분
Skills는 팀이나 조직 전체에 공유될 때 훨씬 더 가치가 커집니다. 이 영상에서는 저장소 커밋, 플러그인, 엔터프라이즈 관리 설정이라는 세 가지 주요 배포 방법을 다루고, 커스텀 서브에이전트가 Skills를 사용하도록 구성하는 방법을 설명합니다. 어떤 접근 방식이 어떤 시나리오에 적합한지, 그리고 중요한 함정인 "서브에이전트는 Skills를 자동으로 상속받지 않는다"는 점을 어떻게 처리해야 하는지 배우게 됩니다.
핵심 요약
.claude/skills에 있는 프로젝트 Skills는 Git을 통해 자동으로 공유됩니다 — 저장소를 클론하는 사람은 누구나 이를 받게 됩니다- 플러그인을 사용하면 마켓플레이스를 통해 저장소 전반에 걸쳐 Skills를 배포하여 더 넓은 커뮤니티에서 사용할 수 있습니다
- 엔터프라이즈 관리 설정은 가장 높은 우선순위로 조직 전체에 Skills를 배포하며, 필수 표준 및 규정 준수에 이상적입니다
- 서브에이전트는 이미 호출된 Skills를 볼 수 없습니다. Skill 도구가 있다면 여전히 Skills를 찾아 호출할 수 있습니다
- 내장 에이전트(Explore, Plan 등)는 Skills를 미리 로드하지 않습니다. 커스텀 서브에이전트만 시작 시 로드할 Skills를
skills필드에 나열할 수 있습니다
Skills는 공유될 때 훨씬 더 가치가 커집니다. 본인만 사용하는 PR 리뷰 Skill도 유용하지만, 같은 Skill을 팀 전체와 공유하면 코드 리뷰가 표준화되고 조직 전체에서 일관된 경험을 만들어낼 수 있습니다. Skills를 배포하는 다양한 방법을 살펴보겠습니다.
저장소에 Skills 커밋하기
가장 간단한 공유 방법은 Skills를 저장소에 직접 커밋하는 것입니다. .claude/skills에 배치하면 저장소를 클론하는 사람은 누구나 별도의 설치 없이 해당 Skills를 자동으로 받게 됩니다.
업데이트를 푸시하면 모든 사람이 다음 pull 시 이를 받게 됩니다. 이 방식은 다음과 같은 경우에 잘 작동합니다:
- 팀 코딩 표준
- 프로젝트별 워크플로우
- 코드베이스 구조를 참조하는 Skills
.claude 디렉터리에는 에이전트, 훅, Skills, 설정이 포함되어 있으며, 이 모두는 버전 관리되고 일반적인 Git 워크플로우를 통해 팀과 공유됩니다.
플러그인을 통한 Skills 배포
플러그인은 팀과 프로젝트 전반에 공유하도록 설계된 커스텀 기능으로 Claude Code를 확장하는 방법입니다. 플러그인 프로젝트에서 .claude 디렉터리와 유사한 파일 구조를 따르는 skills 디렉터리를 만듭니다 — 각 Skill은 내부에 SKILL.md 파일이 있는 자체 폴더를 갖습니다.
플러그인을 마켓플레이스에 배포한 후에는 다른 사용자가 이를 발견하고 직접 Claude Code에 설치할 수 있습니다.

이 방식은 Skills가 특정 프로젝트에 지나치게 종속되지 않고, 직속 팀을 넘어 커뮤니티 구성원에게도 유용할 수 있을 때 가장 적합합니다.
관리 설정을 통한 엔터프라이즈 배포
관리자는 관리 설정을 통해 조직 전체에 Skills를 배포할 수 있습니다. 각 Skill은 각 머신의 관리 설정 디렉터리 내부의 .claude/skills/에 위치하며, 예를 들어 Linux에서는 /etc/claude-code/.claude/skills/입니다. 엔터프라이즈 Skills는 가장 높은 우선순위를 가지며, 동일한 이름의 개인 및 프로젝트 Skills를 재정의합니다.

관리 설정은 플러그인도 제어합니다. 예를 들어, strictKnownMarketplaces는 사람들이 추가하고 플러그인을 설치할 수 있는 마켓플레이스를 제한합니다. 위 스크린샷에는 아무것도 일치하지 않는 npm 항목이 포함되어 있으므로, 이 예시에서는 대신 url 항목을 사용합니다:
"strictKnownMarketplaces": [
{
"source": "github",
"repo": "acme-corp/approved-plugins"
},
{
"source": "url",
"url": "https://plugins.example.com/marketplace.json"
}
]엔터프라이즈 배포는 필수 표준, 보안 요구사항, 규정 준수 워크플로우, 그리고 조직 전체에서 반드시 일관되어야 하는 코딩 관행에 적합한 선택입니다. 여기서 핵심 단어는 "반드시"입니다.
Skills와 서브에이전트
사람들을 놀라게 하는 점이 있습니다: 서브에이전트는 이미 호출된 Skills를 볼 수 없습니다. 작업을 서브에이전트에 위임하면, fork(새 탭에서 열림)인 경우를 제외하고는 새롭고 깨끗한 컨텍스트로 시작합니다. fork는 대화의 사본으로 시작합니다. 새로 시작하는 서브에이전트도 Skill 도구가 있는 한 이를 통해 Skills를 찾아 호출할 수 있습니다.
이해해야 할 중요한 차이점이 있습니다:
- 내장 에이전트(Explore, Plan 등)는 Skills를 미리 로드하지 않습니다
- 직접 정의하는 커스텀 서브에이전트는
skills필드에 나열한 Skills를 미리 로드할 수 있습니다.tools목록을 지정하는 경우, 서브에이전트가 목록에 없는 Skills도 계속 호출할 수 있도록Skill을 그 안에 유지하세요 - 미리 로드된 Skills는 메인 대화에서처럼 필요 시 로드되는 것이 아니라, 서브에이전트가 시작될 때 전체가 로드됩니다
Skills를 갖춘 커스텀 서브에이전트를 만들려면, .claude/agents에 에이전트 마크다운 파일을 추가하세요. 파일을 직접 작성하거나 Claude에게 생성을 요청할 수 있습니다. 세션이 시작될 때 .claude/agents가 존재하지 않았다면, 새 서브에이전트를 로드하기 위해 Claude Code를 재시작하세요. 아래 스크린샷은 Claude Code v2.1.198에서 제거된 /agents 마법사를 보여줍니다.

에이전트 파일의 skills 필드는 로드할 Skills를 나열합니다. 프런트매터는 다음과 같습니다:
---
name: frontend-security-accessibility-reviewer
description: "Use this agent when you need to review frontend code for accessibility..."
tools: Bash, Glob, Grep, Read, WebFetch, WebSearch, Skill...
model: sonnet
color: blue
skills: accessibility-audit, performance-check
---이 서브에이전트에 위임하면, 두 Skills가 모두 로드된 상태에서 모든 리뷰에 적용됩니다. 먼저 해당 Skills가 .claude/skills 디렉터리에 존재하는지 확인한 다음, 새 서브에이전트를 만들거나 기존 에이전트의 마크다운 파일에 skills 필드를 추가하세요.
이 패턴은 다음과 같은 경우에 매우 잘 작동합니다:
- 특정 전문 지식을 갖춘 격리된 작업 위임을 원할 때
- 서로 다른 서브에이전트가 서로 다른 Skills를 필요로 할 때(프런트엔드 리뷰어 vs. 백엔드 리뷰어)
- 프롬프트에 의존하지 않고 위임된 작업에서 표준을 강제하고 싶을 때
레슨 돌아보기
- 구축을 고려 중인 Skills에 가장 적합한 공유 방법(저장소, 플러그인, 엔터프라이즈)은 무엇인가요?
- 특정 Skills를 갖춘 커스텀 서브에이전트가 위임된 작업의 일관성을 개선할 수 있는 워크플로우가 있나요?
다음 단계
마지막 레슨에서는 트리거되지 않는 Skills부터 우선순위 충돌, 런타임 오류에 이르기까지 일반적인 Skill 문제를 해결하는 방법을 실용적인 체크리스트와 함께 배우게 됩니다. 언제든지 참조할 수 있습니다.