스킬 공유하기

잘 만든 스킬을 나 혼자만 쓰면 효과가 거기서 멈춥니다. 같은 스킬을 팀이나 조직이 함께 쓰면, 모두가 같은 기준으로 일하게 됩니다.

예를 들어 PRPull Request. 코드 변경 사항을 팀에 제안해, 합치기 전에 검토받는 단위. 리뷰 스킬을 팀 전체가 쓰면, 누가 리뷰하든 같은 항목을 같은 방식으로 점검합니다. 이 장에서는 공유 범위에 따라 세 가지 방법을 살펴봅니다.

• 저장소에 커밋 — 같은 저장소를 쓰는 팀과 공유.
• 플러그인으로 배포 — 여러 프로젝트·커뮤니티와 공유.
• 엔터프라이즈 관리 설정 — 조직 전체에 강제할 표준.

그리고 마지막으로, 작업을 위임하는 서브에이전트에 스킬을 연결하는 방법까지 다룹니다.

먼저 영상을 보세요. 영어가 어렵다면 아래 한국어를 같이 읽으면 됩니다. 자동 번역과 달리, 낯선 용어를 풀어서 옮겼습니다.

영상 대본 — 영어 영상을 보며 같이 읽으세요 (타임스탬프 기준).

가장 간단한 방법입니다. 스킬을 .claude/skills 폴더에 두고 커밋변경 사항을 저장소에 기록하는 Git 동작.·푸시기록한 변경을 원격 저장소(GitHub 등)에 올리는 동작.하면 됩니다. 그 저장소를 클론하는 사람은 누구나 별도 설치 없이 스킬을 함께 받습니다.

스킬을 고쳐서 다시 푸시하면, 팀원은 다음 풀에서 자동으로 최신 버전을 받습니다. 새로 배포하거나 따로 안내할 필요가 없습니다. .claude 폴더에는 스킬뿐 아니라 에이전트·훅·설정이 함께 들어 있어, 평소 쓰던 Git 흐름 그대로 버전 관리되고 공유됩니다.

저장소 공유 흐름 — 커밋·푸시·클론·풀로 스킬이 어떻게 퍼지는지 단계별로 눌러 보세요.

플러그인Claude Code에 기능을 더하는 꾸러미. 여러 팀·프로젝트가 나눠 쓰도록 설계된 것.은 한 저장소를 넘어 여러 프로젝트·팀·커뮤니티에 스킬을 나눌 때 씁니다. 플러그인 프로젝트 안에 skills 폴더를 만들고, 프로젝트의 .claude 폴더와 같은 구조로 스킬을 둡니다.

플러그인 안의 스킬 구조 — 스킬 이름 폴더 안에 SKILL.md.

my-plugin/
├─ .claude-plugin/
│  └─ plugin.json      ← 플러그인 정보
└─ skills/             ← 여기에 스킬을 둡니다
   └─ pr-review/
      └─ SKILL.md

이 플러그인을 마켓플레이스플러그인을 올리고 내려받는 장터.에 배포하면, 다른 사람들이 자기 Claude Code로 내려받아 씁니다.

조직 관리자조직 전체의 설정을 관리하는 권한을 가진 사람.는 관리 설정을 통해 조직 전체에 스킬을 배포할 수 있습니다. 엔터프라이즈 스킬은 가장 높은 우선순위를 가집니다 — 같은 이름이면 개인·프로젝트·플러그인 스킬을 덮어씁니다.

관리 설정 예시 — 정확한 필드 이름은 공식 문서를 따르세요.

1
2
3
4
5
6
7
8

{
  "extraKnownMarketplaces": {
    "company": {
      "source": { "source": "git", "url": "https://github.com/acme/skills" }
    }
  },
  "enabledPlugins": ["secure-standards@company"]
}

여기에 들어가는 표준은 반드시 지켜야 하는 것입니다 — 필수 표준, 보안 요구사항, 컴플라이언스 작업 흐름, 조직 전체에서 일관돼야 하는 코딩 관행. 핵심어는 ‘반드시’입니다. 관리자는 플러그인을 어떤 마켓플레이스에서 받을 수 있는지도 함께 정할 수 있습니다.

세 방법은 공유 범위로 갈립니다. 같은 저장소면 커밋, 여러 곳에 널리 나누면 플러그인, 조직 전체에 강제하면 엔터프라이즈입니다. 아래에서 상황을 골라, 어떤 방법이 맞는지 확인해 보세요.

여기서 많은 분이 놀랍니다. 서브에이전트큰 작업의 일부를 따로 맡기는 보조 일꾼. 메인 대화와 분리된 깨끗한 컨텍스트에서 시작합니다.는 여러분의 스킬을 자동으로 물려받지 않습니다. 작업을 위임하면 메인 대화와 분리된, 깨끗한 컨텍스트에서 시작하기 때문입니다.

• 내장 에이전트(Explorer·Plan·Verify)는 스킬에 아예 접근할 수 없습니다.
• 커스텀 서브에이전트만 스킬을 쓸 수 있고, 그것도 skills 필드에 명시했을 때만입니다.
• 스킬은 메인 대화처럼 필요할 때가 아니라, 서브에이전트가 시작할 때 한꺼번에 로드됩니다.

커스텀 서브에이전트는 .claude/agents에 agent.md 파일로 정의하고, skills 필드에 불러올 스킬을 적습니다.

1
2
3
4
5
6
7
8
9

---
name: code-reviewer
description: Reviews pull requests for code quality and security.
skills:
  - pr-review
  - security-checklist
---

You are a code reviewer. Apply the loaded skills to every review.

이 서브에이전트에 작업을 위임하면, skills에 적은 스킬이 모두 로드된 채 모든 리뷰에 적용됩니다. 아래에서 에이전트 종류를 바꿔 가며 직접 위임해 보세요.

서브에이전트 스킬 시뮬레이터 — 내장 vs 커스텀, 그리고 skills에 무엇을 넣는지에 따라 결과가 달라집니다.

skills: 

정답을 먼저 떠올려 본 뒤 골라 보세요. 맞히면 설명이 나옵니다.