스킬 공유하기 · 에이전트 스킬 소개

스킬 공유하기 · 4 min

스킬은 팀이나 조직 전체에서 공유될 때 훨씬 더 가치가 커집니다. 이 영상에서는 세 가지 주요 배포 방법 — 저장소 커밋, 플러그인, 엔터프라이즈 관리 설정 — 을 다루고, 커스텀 서브에이전트가 스킬을 사용하도록 구성하는 방법을 설명합니다. 어떤 방식이 어떤 상황에 적합한지, 그리고 중요한 주의사항 — 서브에이전트는 스킬을 자동으로 상속받지 않는다는 점 — 을 처리하는 방법을 배우게 됩니다.

Watch on YouTube

핵심 요약

프로젝트 스킬은 .claude/skills에 위치하며 Git을 통해 자동으로 공유됩니다 — 저장소를 클론하는 누구나 이를 받게 됩니다
플러그인을 사용하면 마켓플레이스를 통해 저장소 간에 스킬을 배포하여 더 넓은 커뮤니티에서 사용할 수 있습니다
엔터프라이즈 관리 설정은 가장 높은 우선순위로 조직 전체에 스킬을 배포하며, 필수 표준 및 규정 준수에 적합합니다
서브에이전트는 여러분의 스킬을 자동으로 인식하지 않습니다 — 커스텀 에이전트의 프런트매터 skills 필드에 명시적으로 스킬을 나열해야 합니다
내장 에이전트(Explorer, Plan, Verify)는 스킬에 전혀 접근할 수 없습니다 — .claude/agents에 정의된 커스텀 서브에이전트만 접근할 수 있습니다

스킬은 공유될 때 훨씬 더 가치가 커집니다. 여러분만 사용하는 PR 리뷰 스킬도 유용하지만, 같은 스킬을 전체 팀과 공유하면 코드 리뷰가 표준화되고 조직 전체에서 일관된 경험을 만들어냅니다. 스킬을 배포할 수 있는 다양한 방법을 살펴보겠습니다.

저장소에 스킬 커밋하기

가장 간단한 공유 방법은 스킬을 저장소에 직접 커밋하는 것입니다. .claude/skills에 배치하면, 저장소를 클론하는 누구나 별도의 설치 없이 자동으로 해당 스킬을 받게 됩니다.

업데이트를 푸시하면 모두가 다음 풀(pull) 시점에 이를 받게 됩니다. 이 방식은 다음과 같은 경우에 잘 작동합니다:

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

.claude 디렉터리에는 에이전트, 훅, 스킬, 설정이 포함되어 있으며 — 모두 버전 관리되고 일반적인 Git 워크플로를 통해 팀과 공유됩니다.

플러그인을 통한 스킬 배포

플러그인은 팀과 프로젝트 전반에 공유되도록 설계된 커스텀 기능으로 Claude Code를 확장하는 방법입니다. 플러그인 프로젝트에서 .claude 디렉터리와 유사한 파일 구조를 따르는 skills 디렉터리를 생성합니다 — 각 스킬은 내부에 SKILL.md 파일이 있는 자체 폴더를 가집니다.

플러그인을 마켓플레이스에 배포한 후, 다른 사용자들은 이를 발견하고 직접 Claude Code에 설치할 수 있습니다.

이 방식은 스킬이 너무 프로젝트 특화적이지 않고 직속 팀을 넘어 커뮤니티 구성원에게도 유용할 수 있을 때 가장 적합합니다.

관리 설정을 통한 엔터프라이즈 배포

관리자는 관리 설정을 통해 조직 전체에 스킬을 배포할 수 있습니다. 엔터프라이즈 스킬은 가장 높은 우선순위를 가지며 — 동일한 이름을 가진 개인, 프로젝트, 플러그인 스킬을 재정의합니다.

관리 설정 파일은 플러그인을 설치할 수 있는 위치를 제어하는 strictKnownMarketplaces와 같은 기능을 지원합니다:

json

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

이는 조직 전체에서 반드시 일관되어야 하는 필수 표준, 보안 요구사항, 규정 준수 워크플로, 코딩 관행에 적합한 선택입니다. 여기서 핵심 단어는 "반드시"입니다.

스킬과 서브에이전트

사람들을 놀라게 하는 사실이 있습니다: 서브에이전트는 여러분의 스킬을 자동으로 인식하지 않습니다. 작업을 서브에이전트에 위임하면, 서브에이전트는 새롭고 깨끗한 컨텍스트로 시작합니다.

이해해야 할 중요한 구분이 있습니다:

내장 에이전트(Explorer, Plan, Verify 등)는 스킬에 전혀 접근할 수 없습니다
여러분이 정의한 커스텀 서브에이전트는 스킬을 사용할 수 있지만, 명시적으로 나열한 경우에만 가능합니다
스킬은 메인 대화에서처럼 필요에 따라 로드되는 것이 아니라, 서브에이전트가 시작될 때 로드됩니다

스킬을 사용하는 커스텀 서브에이전트를 만들려면, .claude/agents에 에이전트 마크다운 파일을 추가하세요. Claude Code에서 /agents 명령을 사용하여 대화형으로 생성할 수 있습니다:

생성된 에이전트 파일에는 로드할 스킬을 나열하는 skills 필드가 포함됩니다. 프런트매터는 다음과 같습니다:

yaml

---
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
---

이 서브에이전트에 위임하면, 두 스킬이 모두 로드되어 모든 리뷰에 적용됩니다. 먼저 .claude/skills 디렉터리에 스킬이 존재하는지 확인한 다음, 새 서브에이전트를 만들거나 기존 에이전트의 마크다운 파일에 skills 필드를 추가하세요.

이 패턴은 다음과 같은 경우에 매우 잘 작동합니다:

특정 전문성을 가진 격리된 작업 위임을 원할 때
서로 다른 서브에이전트가 서로 다른 스킬을 필요로 할 때(프런트엔드 리뷰어 vs. 백엔드 리뷰어)
프롬프트에 의존하지 않고 위임된 작업에서 표준을 강제하고 싶을 때

레슨 되돌아보기

여러분이 구축하려고 생각해온 스킬에 가장 적합한 공유 방법(저장소, 플러그인, 엔터프라이즈)은 무엇인가요?
특정 스킬을 가진 커스텀 서브에이전트가 위임된 작업의 일관성을 개선할 수 있는 워크플로가 있나요?

다음 단계

마지막 레슨에서는 트리거되지 않는 스킬부터 우선순위 충돌, 런타임 오류까지 일반적인 스킬 문제를 해결하는 방법을 언제든지 참조할 수 있는 실용적인 체크리스트와 함께 배우게 됩니다.