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

스킬 공유하기 · 4 min

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

한국어 대본

00:00Skills는 공유될 때 더 가치 있게 됩니다.
00:05혼자만 사용하는 PR 리뷰 skill도 유용합니다.
00:08팀 전체에 공유되는 동일한 skill은
00:10코드 리뷰를 표준화하고 일관된
00:12경험을 조직 전반에 제공하여
00:14훨씬 더 나은 것입니다.
00:16Skills를 공유하는 방법은 다음과 같습니다.
00:20이제 가장 간단한 공유 방법은
00:22skills를 저장소에 커밋하는 것입니다.
00:24이를 .cloud/skills에 넣으세요.
00:27저장소를 클론하는 사람은 누구나 이러한 skills를 자동으로 받게 됩니다.
00:31추가 설치가 필요 없으며, 이미 하고 있는 작업일 뿐입니다.
00:35업데이트를 push하면 다음에 pull할 때 모두가 해당 skills를 받게 됩니다.
00:38이는 팀 코딩 표준, 프로젝트별 워크플로,
00:43코드 기반 구조를 참조하는 skills에 잘 맞습니다.
00:47Skills를 배포하는 또 다른 방법은 Plugins를 통한 것입니다.
00:50Plugins를 사용자 지정 기능으로 Claude Code를 확장하는 방법으로 생각하세요.
00:55하지만 팀과 프로젝트 전반에 공유되도록 설계되었습니다.
01:01Plugin 프로젝트에서 skills라는 디렉터리를 만드세요.
01:04이는 .cloud 디렉터리와 유사한 파일 구조를 따릅니다.
01:08프로젝트에서 skill 이름과 함께 skill.mv 파일을 포함합니다.
01:13그리고 Plugin을 마켓플레이스에 배포한 후에는
01:16다른 사용자들은 이를 Claude Code에 다운로드하여 직접 사용할 수 있습니다.
01:20이는 skills의 기능이 특정 프로젝트에 너무 국한되지 않고
01:25커뮤니티 구성원이 사용할 수 있을 때 가장 좋습니다.
01:30관리자는 관리 설정을 통해 조직 전체에 skills를 배포할 수 있습니다.
01:34엔터프라이즈 skills가 최우선 순위를 가집니다.
01:37앞서 논의한 대로, 이들은 같은 이름을 가진 개인 프로젝트 및 plugin skills를 덮어씁니다.
01:42이것은 필수 표준, 보안 요구 사항, 규정 준수 워크플로를 위한 것입니다,
01:47조직 전체에서 일관되어야 하는 코딩 관행.
01:51키워드 필수.
01:52사람들을 놀라게 하는 것이 있습니다. Subagents는 사용자의 skills를 자동으로 볼 수 없습니다.
01:58네, Subagent에게 작업을 위임하면 새롭고 깨끗한 컨텍스트로 시작합니다. 내장 에이전트는
02:05explorer, plan, verify 같은 내장 에이전트는 skills에 전혀 접근할 수 없습니다. 오직 사용자가 정의한 사용자 지정 Subagent만
02:11그것들을 사용할 수 있고, 사용자가 skills를 가진 사용자 지정 Subagent를 생성하기 위해 명시적으로 나열할 때만 가능합니다.
02:16.clad/agents에 agent.md 파일을 추가하세요.
02:20skills 필드는 로드할 skills를 나열합니다.
02:22이러한 skills는 Subagent가 시작될 때 로드됩니다,
02:25주 대화에서처럼 요청 시 로드되는 것이 아닙니다.
02:28그러므로 그 점을 고려하세요.
02:30먼저 skills가 존재하는지 확인하세요.
02:34네, 존재합니다.
02:37그런 다음 clad code Subagent 생성기를 사용하여 Subagent를 생성하세요.
02:41이미 이러한 skills를 추가하려는 Subagent가 있다면,
02:44기존 agent.md 파일로 이동하세요. 그런 다음 skills 필드를 만들고 skills를 추가하세요.
02:51Subagent에게 위임하면, 그 Subagent는 두 skills를 모두 로드한 상태로 그것들을 모든 단일
02:55리뷰에 적용합니다. 이 패턴은 특정
03:03전문 지식. 서로 다른 Subagent는 서로 다른 skills가 필요합니다. 프런트엔드 리뷰어와 백엔드
03:09리뷰어 중 어느 쪽입니까? 프롬프트에 의존하지 않고 위임된 작업에서 표준을 적용하려는 것입니다.
03:14Subagent의 목적에 항상 관련된 skills만 나열하세요.
03:20프로젝트 디렉터리를 통해 팀이 접근할 수 있도록 Skills를 공유하거나, Plugins로 여러 리포지토리에 걸쳐
03:25배포하거나, 조직 전체의 표준을 위한 엔터프라이즈 배포를 사용하세요. Subagents는
03:30Skills를 자동으로 상속하지 않으므로, subagent의 skills 필드에 명시적으로 나열하세요.
03:35기본 제공 에이전트는 Skills에 접근할 수 없습니다. 커스텀 sub-agents만 .clause.agents에서 접근할 수 있습니다.
03:42Skills는 sub-agent가 시작될 때 로드되므로, 항상 그 목적과 관련된 Skills만 나열하세요.

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. 백엔드 리뷰어)
프롬프트에 의존하지 않고 위임된 작업에서 표준을 강제하고 싶을 때

레슨 되돌아보기

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

다음 단계

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