Skills는 Pro, Max, Team, Enterprise 플랜의 사용자가 이용할 수 있습니다. 이 기능을 사용하려면 코드 실행이 활성화되어야 합니다. Skills는 Claude Code 사용자와 코드 실행 도구를 사용하는 모든 API 사용자를 위해 베타 버전으로도 제공됩니다.
Custom Skills를 사용하면 조직이나 개인의 작업 스타일에 맞는 전문 지식과 워크플로우로 Claude를 강화할 수 있습니다. 이 문서에서는 자신만의 Skills를 만들고, 구조화하고, 테스트하는 방법을 설명합니다.
Skills는 몇 줄의 지침부터 실행 가능한 코드가 포함된 다중 파일 패키지까지 다양할 수 있습니다. 최고의 Skills는 다음과 같은 특징이 있습니다:
특정하고 반복 가능한 작업을 해결합니다
Claude가 따를 수 있는 명확한 지침이 있습니다
도움이 될 때 예제를 포함합니다
사용해야 할 시기를 정의합니다
모든 것을 하려고 하기보다는 하나의 워크플로우에 집중합니다
Skill.md 파일 만들기
모든 Skill은 최소한 Skill.md 파일을 포함하는 디렉토리로 구성되며, 이 파일이 Skill의 핵심입니다. 이 파일은 필수 메타데이터인 name과 description 필드를 포함하는 YAML 프론트매터로 시작해야 합니다. 추가 메타데이터, Claude를 위한 지침 또는 참조 파일, 실행 가능한 스크립트 또는 도구를 포함할 수도 있습니다.
필수 메타데이터 필드
name: Skill의 사용자 친화적 이름(최대 64자)
예: Brand Guidelines
description: Skill이 무엇을 하는지, 언제 사용하는지에 대한 명확한 설명입니다.
이것은 매우 중요합니다. Claude는 이를 사용하여 Skill을 호출할 시기를 결정합니다(최대 200자).
예: 공식 색상, 글꼴, 로고 사용법을 포함하여 프레젠테이션 및 문서에 Acme Corp 브랜드 가이드라인을 적용합니다.
선택적 메타데이터 필드
dependencies: Skill에 필요한 소프트웨어 패키지입니다.
예: python>=3.8, pandas>=1.5.0
Skill.md 파일의 메타데이터는 점진적 공개 시스템의 첫 번째 수준으로 작용하여 Claude가 모든 콘텐츠를 로드할 필요 없이 Skill을 사용해야 할 시기를 알 수 있도록 충분한 정보를 제공합니다.
마크다운 본문
마크다운 본문은 메타데이터 이후의 두 번째 세부 정보 수준이므로, Claude는 메타데이터를 읽은 후 필요하면 이에 접근할 수 있습니다. 작업에 따라 Claude는 Skill.md 파일에 접근하여 Skill을 사용할 수 있습니다.
Skill.md 예제
Brand Guidelines Skill
## 메타데이터
name: Brand Guidelines
description: 모든 프레젠테이션 및 문서에 Acme Corp 브랜드 가이드라인 적용
## 개요
이 Skill은 일관되고 전문적인 자료를 만들기 위한 Acme Corp의 공식 브랜드 가이드라인을 제공합니다. 프레젠테이션, 문서 또는 마케팅 자료를 만들 때 이러한 표준을 적용하여 모든 결과물이 Acme의 시각적 정체성과 일치하도록 하세요. Claude는 외부 공개 자료나 Acme Corp를 대표하는 문서를 만들 때마다 이러한 가이드라인을 참조해야 합니다.
## 브랜드 색상
공식 브랜드 색상은 다음과 같습니다:
- 주요: #FF6B35 (산호색)
- 보조: #004E89 (네이비 블루)
- 강조: #F7B801 (금색)
- 중립: #2E2E2E (차콜)
## 타이포그래피
헤더: Montserrat Bold
본문: Open Sans Regular
크기 가이드라인:
- H1: 32pt
- H2: 24pt
- 본문: 11pt
## 로고 사용
밝은 배경에는 항상 풀 컬러 로고를 사용하세요. 어두운 배경에는 흰색 로고를 사용하세요. 로고 주변에 최소 0.5인치의 간격을 유지하세요.
## 적용 시기
다음을 만들 때 이러한 가이드라인을 적용하세요:
- PowerPoint 프레젠테이션
- 외부 공유용 Word 문서
- 마케팅 자료
- 클라이언트 보고서
## 리소스
로고 파일 및 글꼴 다운로드는 리소스 폴더를 참조하세요.
리소스 추가
단일 Skill.md 파일에 추가할 정보가 너무 많은 경우(예: 특정 시나리오에만 적용되는 섹션), Skill 디렉토리 내에 파일을 추가하여 더 많은 콘텐츠를 추가할 수 있습니다. 예를 들어, 보충 및 참조 정보가 포함된 REFERENCE.md 파일을 Skill 디렉토리에 추가하세요. Skill.md에서 이를 참조하면 Claude가 Skill을 실행할 때 해당 리소스에 접근해야 하는지 결정하는 데 도움이 됩니다.
스크립트 추가
더 고급 Skills의 경우, Skill.md에 실행 가능한 코드 파일을 첨부하여 Claude가 코드를 실행할 수 있도록 합니다. 예를 들어, 당사의 문서 skills는 다음 프로그래밍 언어 및 패키지를 사용합니다:
Python (pandas, numpy, matplotlib)
JavaScript/Node.js
파일 편집을 돕는 패키지
시각화 도구
참고: Claude와 Claude Code는 Skills를 로드할 때 표준 저장소(Python PyPI, JavaScript npm)에서 패키지를 설치할 수 있습니다. API Skills의 경우 런타임에 추가 패키지를 설치할 수 없습니다. 모든 종속성은 컨테이너에 사전 설치되어야 합니다.
Skill 패키징
Skill 폴더가 완성되면:
폴더 이름이 Skill의 이름과 일치하는지 확인하세요.
폴더의 ZIP 파일을 만드세요.
ZIP은 Skill 폴더를 루트로 포함해야 합니다(하위 폴더가 아님).
올바른 구조:
my-Skill.zip
└── my-Skill/
├── Skill.md
└── resources/
잘못된 구조:
my-Skill.zip
└── (ZIP 루트에 직접 파일)
Skill 테스트
업로드 전
1. Skill.md의 명확성을 검토하세요
2. 설명이 Claude가 Skill을 사용해야 할 시기를 정확히 반영하는지 확인하세요
3. 참조된 모든 파일이 올바른 위치에 있는지 확인하세요
4. 예제 프롬프트로 테스트하여 Claude가 적절하게 호출하는지 확인하세요
Claude에 업로드한 후
1. 설정 > 기능에서 Skill을 활성화하세요.
2. 이를 트리거해야 하는 여러 프롬프트를 시도하세요
3. Claude의 생각을 검토하여 Skill이 로드되는지 확인하세요
4. Claude가 예상대로 사용하지 않으면 설명을 반복하세요
Team 및 Enterprise 플랜 사용자 참고: 조직의 모든 사용자가 skill을 사용할 수 있도록 하려면 조직을 위한 Skills 프로비저닝 및 관리를 참조하세요.
모범 사례
집중력 유지: 다양한 워크플로우에 대해 별도의 Skills를 만드세요. 여러 개의 집중된 Skills가 하나의 큰 Skill보다 더 잘 구성됩니다.
명확한 설명 작성: Claude는 설명을 사용하여 Skill을 호출할 시기를 결정합니다. 적용되는 시기에 대해 구체적으로 작성하세요.
간단하게 시작: 복잡한 스크립트를 추가하기 전에 마크다운의 기본 지침으로 시작하세요. 나중에 언제든지 Skill을 확장할 수 있습니다.
예제 사용: Skill.md 파일에 예제 입력 및 출력을 포함하여 Claude가 성공이 무엇인지 이해하도록 도와주세요.
점진적으로 테스트: 한 번에 복잡한 Skill을 만들기보다는 각 중요한 변경 후에 테스트하세요.
Skills는 서로 기반이 될 수 있습니다: Skills가 다른 Skills를 명시적으로 참조할 수는 없지만, Claude는 여러 Skills를 자동으로 함께 사용할 수 있습니다. 이러한 구성 가능성은 Skills 기능의 가장 강력한 부분 중 하나입니다.
공개 Agent Skills 사양 검토: agentskills.io의 가이드라인을 따르면 만든 skills가 표준을 채택한 플랫폼 전체에서 작동할 수 있습니다.
더 심층적인 skill 생성 가이드는 Claude Docs의 Skill 작성 모범 사례를 참조하세요.
보안 고려 사항
Skill.md 파일에 스크립트를 추가할 때 주의하세요.
민감한 정보(API 키, 비밀번호)를 하드코딩하지 마세요.
활성화하기 전에 다운로드한 모든 Skills를 검토하세요.
외부 서비스 접근을 위해 적절한 MCP 연결을 사용하세요.
참조할 예제 Skills
GitHub의 저장소를 방문하여 템플릿으로 사용할 수 있는 예제 Skills를 확인하세요: https://github.com/anthropics/skills/tree/main/skills.