Ai 마법서

Anthropic Courses 4

11 min read

스킬 공유

학습할 내용

예상 소요 시간: 20분

본 강의가 끝날 때쯤 다음을 수행할 수 있습니다.

  • Git 리포지토리에 커밋하여 팀과 스킬 공유
  • 플러그인 및 마켓플레이스를 통해 프로젝트 전반에 스킬 배포
  • 엔터프라이즈 관리 설정을 사용하여 조직 전체에 스킬 배포
  • 특정 스킬을 사용하도록 사용자 지정 하위 에이전트 구성

스킬 공유

(4분)

스킬은 팀이나 조직 전체에서 공유될 때 훨씬 더 가치가 높아집니다. 이 비디오에서는 세 가지 주요 배포 방법(리포지토리 커밋, 플러그인, 엔터프라이즈 관리 설정)을 다루며 사용자 지정 하위 에이전트가 스킬을 사용하도록 구성하는 방법을 설명합니다. 어떤 접근 방식이 어떤 시나리오에 적합한지, 그리고 중요한 함정인 하위 에이전트는 스킬을 자동으로 상속하지 않는다는 점을 처리하는 방법을 배웁니다.

주요 요점

  • .claude/skills의 프로젝트 스킬은 Git을 통해 자동으로 공유됩니다 — 리포지토리를 클론하는 모든 사용자가 해당 스킬을 사용합니다.
  • 플러그인을 사용하면 마켓플레이스를 통해 리포지토리 전반에 스킬을 배포하여 더 광범위한 커뮤니티에서 사용할 수 있습니다.
  • 엔터프라이즈 관리 설정은 최고 우선순위로 조직 전체에 스킬을 배포하며, 필수 표준 및 규정 준수에 이상적입니다.
  • 하위 에이전트는 스킬을 자동으로 볼 수 없습니다 — 사용자 지정 에이전트의 프론트매터 skills 필드에 스킬을 명시적으로 나열해야 합니다.
  • 내장 에이전트(Explorer, Plan, Verify)는 스킬에 전혀 액세스할 수 없습니다 — .claude/agents에 정의된 사용자 지정 하위 에이전트만 액세스할 수 있습니다.

스킬은 공유될 때 훨씬 더 가치가 높아집니다. 귀하만 사용하는 PR 검토 스킬도 유용하지만, 전체 팀과 공유되는 동일한 스킬은 코드 검토를 표준화하고 조직 전체에 일관된 경험을 만듭니다. 스킬을 배포하는 다양한 방법을 살펴보겠습니다.

리포지토리에 스킬 커밋

가장 간단한 공유 방법은 스킬을 리포지토리에 직접 커밋하는 것입니다. 스킬을 .claude/skills에 배치하면 리포지토리를 클론하는 모든 사용자가 추가 설치 없이 자동으로 해당 스킬을 사용하게 됩니다.

업데이트를 푸시하면 다음 풀에서 모든 사용자에게 업데이트된 스킬이 제공됩니다. 이 접근 방식은 다음의 경우에 유용합니다.

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

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

플러그인을 통한 스킬 배포

플러그인은 팀 및 프로젝트 전반에 공유되도록 설계된 사용자 지정 기능을 통해 Claude Code를 확장하는 방법입니다. 플러그인 프로젝트에서 .claude 디렉터리와 유사한 파일 구조를 따르는 skills 디렉터리를 만듭니다. 각 스킬은 내부에 SKILL.md 파일이 있는 자체 폴더를 갖습니다.

플러그인을 마켓플레이스에 배포한 후 다른 사용자는 이를 검색하여 Claude Code에 직접 설치할 수 있습니다.

이 접근 방식은 스킬이 지나치게 프로젝트에 국한되지 않고 즉각적인 팀을 넘어 커뮤니티 구성원에게 유용할 수 있을 때 가장 적합합니다.

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

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

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

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

이는 필수 표준, 보안 요구 사항, 규정 준수 워크플로우 및 조직 전체에서 반드시 일관되어야 하는 코딩 관행에 대한 올바른 선택입니다. 여기서 핵심 키워드는 “반드시”입니다.

스킬 및 하위 에이전트

사람들을 놀라게 하는 사실이 있습니다. 하위 에이전트는 스킬을 자동으로 볼 수 없습니다. 하위 에이전트에게 작업을 위임할 때, 하위 에이전트는 새롭고 깨끗한 컨텍스트에서 시작합니다.

이해해야 할 중요한 차이점이 있습니다.

  • 내장 에이전트(Explorer, Plan, Verify 등)는 스킬에 전혀 액세스할 수 없습니다.
  • 정의한 사용자 지정 하위 에이전트는 스킬을 사용할 수 있지만, 명시적으로 나열한 경우에만 가능합니다.
  • 스킬은 기본 대화에서처럼 필요할 때 로드되는 것이 아니라 하위 에이전트가 시작될 때 로드됩니다.

스킬이 포함된 사용자 지정 하위 에이전트를 생성하려면 .claude/agents에 에이전트 마크다운 파일을 추가합니다. Claude Code에서 /agents 명령을 사용하여 대화형으로 생성할 수 있습니다.

생성된 에이전트 파일에는 로드할 스킬을 나열하는 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
---

이 하위 에이전트에게 작업을 위임하면 두 스킬이 모두 로드되어 모든 검토에 적용됩니다. 먼저 스킬이 .claude/skills 디렉터리에 있는지 확인한 다음, 새 하위 에이전트를 생성하거나 기존 에이전트의 마크다운 파일에 skills 필드를 추가합니다.

이 패턴은 다음과 같은 경우에 매우 유용합니다.

  • 특정 전문 지식을 갖춘 격리된 작업 위임이 필요한 경우
  • 서로 다른 하위 에이전트가 서로 다른 스킬을 필요로 하는 경우(프론트엔드 검토자 대 백엔드 검토자)
  • 프롬프트에 의존하지 않고 위임된 작업에서 표준을 적용하려는 경우

강의 되돌아보기

  • 구축을 고려하고 있는 스킬에 대해 어떤 공유 방법(리포지토리, 플러그인, 엔터프라이즈)이 가장 적합해 보입니까?
  • 위임된 작업의 일관성을 개선하기 위해 특정 스킬을 갖춘 사용자 지정 하위 에이전트가 유용할 수 있는 워크플로우가 있습니까?

다음 단계

마지막 강의에서는 스킬이 트리거되지 않는 문제, 우선순위 충돌, 런타임 오류와 같은 일반적인 스킬 문제를 언제든지 참조할 수 있는 실용적인 체크리스트를 사용하여 해결하는 방법을 배웁니다.

피드백

과정을 진행하면서 업무에서 스킬을 어떻게 활용하고 있는지, 그리고 가지신 피드백을 듣고 싶습니다. 여기에서 피드백을 공유해 주세요.

Graph View