🤝 Claude Code Skills — 팀과 조직에 공유하기(Sharing skills)

🤝 Claude Code Skills — 팀과 조직에 공유하기

Git 커밋 · 플러그인 · 엔터프라이즈 배포 · Subagents 연동

📌 이 글의 핵심 요약

• .claude/skills에 커밋한 프로젝트 스킬은 Git을 통해 팀 전체에 자동 공유됩니다.
• 플러그인으로 배포하면 여러 저장소와 커뮤니티에 스킬을 확산시킬 수 있습니다.
• Enterprise 관리 설정으로 스킬을 조직 전체에 배포하면 최우선 우선순위로 적용됩니다.
• Subagents는 스킬을 자동으로 상속하지 않습니다. frontmatter의 skills 필드에 명시해야 합니다.
• 내장 에이전트(Explorer, Plan, Verify)는 스킬에 접근할 수 없습니다. 커스텀 Subagent만 가능합니다.

혼자만 쓰는 PR 리뷰 스킬은 유용하지만, 팀 전체가 같은 스킬을 쓴다면 코드 리뷰 품질이 조직 전반에서 일관되게 유지됩니다. 스킬을 공유하는 방법은 상황에 따라 3가지로 나뉩니다.

1. 스킬 배포 방법 3가지

①

저장소 커밋 (Git) 가장 간단

.claude/skills에 스킬을 넣고 커밋하면 끝. 저장소를 클론한 팀원 모두가 별도 설치 없이 자동으로 스킬을 갖게 됩니다. 업데이트를 push하면 팀원들은 pull 시 자동 반영됩니다.

팀 코딩 표준 프로젝트별 워크플로우 코드베이스 구조 참조 스킬

②

플러그인 배포 크로스 저장소

플러그인 프로젝트에 skills 디렉토리를 만들고 마켓플레이스에 배포합니다. 다른 사용자들이 Claude Code에 설치하여 사용할 수 있습니다. 특정 프로젝트에 종속되지 않는 범용 스킬에 적합합니다.

여러 저장소에서 재사용 커뮤니티 공유 범용 워크플로우

③

Enterprise 관리 설정 조직 전체 필수 적용

관리자가 관리 설정을 통해 조직 전체에 스킬을 배포합니다. 같은 이름의 스킬이 있을 경우 최고 우선순위로 덮어씁니다. 반드시 지켜야 하는 표준, 보안 요구사항, 컴플라이언스 워크플로우에 사용합니다.

필수 보안 표준 컴플라이언스 워크플로우 조직 전체 코딩 관례

---

2. 저장소 커밋으로 팀과 공유하기

가장 간단하고 자연스러운 방법입니다. .claude 디렉토리 전체를 버전 관리하면 스킬, 에이전트, hooks, 설정이 모두 팀과 공유됩니다.

.claude/ ← 이 디렉토리 전체를 Git으로 관리
├── skills/
│ ├── pr-review/
│ │ └── SKILL.md ← 팀 PR 리뷰 기준
│ └── commit-message/
│ └── SKILL.md ← 팀 커밋 메시지 형식
├── agents/
├── hooks/
└── settings.json

스킬 작성.claude/skills에 SKILL.md 추가

→

Git 커밋 & Push일반 Git 워크플로우

→

팀원 Pull클론 또는 pull 시 자동 적용

→

즉시 사용 가능별도 설치 없음

스킬을 업데이트하면 팀원들은 다음 git pull 때 자동으로 최신 버전을 받게 됩니다. 별도의 배포 과정이 필요 없습니다.

---

3. 플러그인으로 더 넓게 배포하기

특정 프로젝트에 종속되지 않는 스킬이라면 플러그인으로 만들어 마켓플레이스에 배포할 수 있습니다. 플러그인 프로젝트 내부에 skills 디렉토리를 만들고 .claude 디렉토리와 동일한 파일 구조를 따르면 됩니다.

my-plugin/
└── skills/ ← .claude 디렉토리와 동일한 구조
    ├── code-review/
    │ └── SKILL.md
    └── commit-helper/
        └── SKILL.md

플러그인 방식은 스킬이 프로젝트에 종속적이지 않고 커뮤니티 전반에 유용한 범용 기능일 때 선택하세요.

---

4. Enterprise 관리 설정으로 조직 전체 배포

관리자는 strictKnownMarketplaces 설정으로 조직 내에서 허용되는 플러그인 출처를 제어할 수도 있습니다.

managed-settings.json — 허용 마켓플레이스 설정

"strictKnownMarketplaces": [
  {
    "source": "github",
    "repo":   "acme-corp/approved-plugins"
  },
  {
    "source":  "npm",
    "package": "@acme-corp/compliance-plugins"
  }
]

Enterprise 배포는 우선순위가 가장 높습니다. 동일한 이름의 스킬이 개인·프로젝트·플러그인에 있어도 Enterprise 스킬이 항상 우선 적용됩니다.

Enterprise

Personal

Project

Plugins

최고 우선순위 ↑

최저 우선순위 ↓

Enterprise 스킬은 키워드는 "반드시(must)" 입니다. 보안 요건, 컴플라이언스, 필수 코딩 관례처럼 예외 없이 지켜야 할 것만 여기에 넣으세요.

---

5. Subagents에 스킬 연결하기

많은 사람들이 놓치는 중요한 포인트가 있습니다. Subagents는 스킬을 자동으로 상속하지 않습니다. 서브에이전트에 작업을 위임하면 깨끗한 새 컨텍스트에서 시작합니다.

❌ 스킬에 접근 불가

내장 에이전트
Explorer, Plan, Verify 등

스킬에 전혀 접근할 수 없습니다. 어떤 방법으로도 스킬을 연결할 수 없습니다.

✅ 스킬 연결 가능

커스텀 Subagents
.claude/agents에 직접 정의

frontmatter의 skills 필드에 사용할 스킬을 명시하면 연결됩니다.

커스텀 Subagent에 스킬 연결하는 방법

Claude Code에서 /agents 명령으로 새 에이전트를 만들거나, 기존 에이전트 파일의 frontmatter에 skills 필드를 추가합니다.

.claude/agents/frontend-reviewer.md

---
name:        frontend-security-accessibility-reviewer
description: "Use this agent when you need to review frontend
              code for accessibility and security issues."
tools:       Bash, Glob, Grep, Read, WebFetch, WebSearch, Skill
model:       sonnet
color:       blue
skills:      accessibility-audit, performance-check   ← 핵심!
---

# 에이전트 지시 내용
프론트엔드 코드를 리뷰할 때 위 스킬의 기준을 적용하세요.

Subagent에서 스킬은 시작 시 바로 로드됩니다. 메인 대화에서처럼 요청에 따라 매칭되는 방식이 아닙니다. 먼저 .claude/skills에 해당 스킬이 있는지 확인하세요.

커스텀 Subagent에 스킬을 연결하면 좋은 경우

상황	이유
특정 전문성이 필요한 독립 태스크 위임	스킬이 위임 작업에서도 일관된 기준을 제공
서브에이전트마다 다른 스킬이 필요한 경우	프론트엔드 리뷰어 vs 백엔드 리뷰어처럼 역할 분리
프롬프트 없이 위임 작업의 표준을 강제하고 싶을 때	매번 지시하지 않아도 스킬이 자동 적용

---

6. 상황에 맞는 배포 방법 선택하기

상황	권장 방법
한 팀, 하나의 저장소에서 공유	Git 커밋
여러 저장소 또는 오픈소스 커뮤니티에 배포	플러그인
회사 전체에 필수로 적용해야 하는 표준	Enterprise
특정 전문성을 가진 서브에이전트 구성	Subagent skills 필드

핵심 원칙 ✨

혼자 쓰는 스킬은 도구지만,
팀이 함께 쓰는 스킬은 조직의 표준이 됩니다.

Git 커밋 → 플러그인 → Enterprise,
필요한 범위에 맞는 방법을 선택하세요 🚀