스킬은 무료, Pro, Max, Team 및 Enterprise 플랜의 사용자가 사용할 수 있습니다. 이 기능을 사용하려면 코드 실행이 활성화되어야 합니다. 스킬은 Claude Code 사용자와 코드 실행 도구를 사용하는 모든 API 사용자를 위해 베타 버전으로도 제공됩니다.
사용자 정의 스킬을 사용하면 조직이나 개인 작업 스타일에 맞는 전문 지식과 워크플로우로 Claude를 향상시킬 수 있습니다. 이 문서에서는 자신의 스킬을 만들고, 구조화하고, 테스트하는 방법을 설명합니다.
스킬은 몇 줄의 지침만큼 간단하거나 실행 가능한 코드가 있는 다중 파일 패키지만큼 복잡할 수 있습니다. 최고의 스킬은:
특정하고 반복 가능한 작업을 해결합니다
Claude가 따를 수 있는 명확한 지침이 있습니다
도움이 될 때 예제를 포함합니다
사용해야 할 시기를 정의합니다
모든 것을 하려고 하기보다는 하나의 워크플로우에 집중합니다
skill.md 파일 만들기
모든 스킬은 최소한 스킬의 핵심인 skill.md 파일을 포함하는 디렉토리로 구성됩니다. 이 파일은 필수 메타데이터인 이름 및 설명 필드를 보유하기 위해 YAML 프론트매터로 시작해야 합니다. 또한 추가 메타데이터, Claude에 대한 지침 또는 참조 파일, 실행 가능한 스크립트 또는 도구를 포함할 수 있습니다.
필수 메타데이터 필드
name: 스킬의 사용자 친화적 이름(최대 64자)
예: Brand Guidelines
description: 스킬이 수행하는 작업과 사용 시기에 대한 명확한 설명입니다.
이것은 중요합니다. Claude는 이를 사용하여 스킬을 호출할 시기를 결정합니다(최대 200자).
예: 공식 색상, 글꼴 및 로고 사용을 포함하여 프레젠테이션 및 문서에 Acme Corp 브랜드 지침을 적용합니다.
선택적 메타데이터 필드
dependencies: 스킬에 필요한 소프트웨어 패키지입니다.
예: python>=3.8, pandas>=1.5.0
skill.md 파일의 메타데이터는 점진적 공개 시스템의 첫 번째 수준으로 작용하여 Claude가 모든 콘텐츠를 로드할 필요 없이 스킬을 사용해야 할 시기를 알 수 있도록 충분한 정보를 제공합니다.
마크다운 본문
마크다운 본문은 메타데이터 이후의 두 번째 세부 정보 수준이므로 Claude는 메타데이터를 읽은 후 필요한 경우 이에 액세스합니다. 작업에 따라 Claude는 skill.md 파일에 액세스하고 스킬을 사용할 수 있습니다.
예제 skill.md
브랜드 지침 스킬
## Metadata
name: Brand Guidelines
description: Apply Acme Corp brand guidelines to all presentations and documents
## Overview
This skill provides Acme Corp's official brand guidelines for creating consistent, professional materials. When creating presentations, documents, or marketing materials, apply these standards to ensure all outputs match Acme's visual identity. Claude should reference these guidelines whenever creating external-facing materials or documents that represent Acme Corp.
## Brand Colors
Our official brand colors are:
- Primary: #FF6B35 (Coral)
- Secondary: #004E89 (Navy Blue)
- Accent: #F7B801 (Gold)
- Neutral: #2E2E2E (Charcoal)
## Typography
Headers: Montserrat Bold
Body text: Open Sans Regular
Size guidelines:
- H1: 32pt
- H2: 24pt
- Body: 11pt
## Logo Usage
Always use the full-color logo on light backgrounds. Use the white logo on dark backgrounds. Maintain minimum spacing of 0.5 inches around the logo.
## When to Apply
Apply these guidelines whenever creating:
- PowerPoint presentations
- Word documents for external sharing
- Marketing materials
- Reports for clients
## Resources
See the resources folder for logo files and font downloads.
리소스 추가
단일 skill.md 파일에 추가할 정보가 너무 많은 경우(예: 특정 시나리오에만 적용되는 섹션), 스킬 디렉토리 내에 파일을 추가하여 콘텐츠를 추가할 수 있습니다. 예를 들어, 스킬 디렉토리에 보충 및 참조 정보를 포함하는 REFERENCE.md 파일을 추가합니다. skill.md에서 이를 참조하면 Claude가 스킬을 실행할 때 해당 리소스에 액세스해야 하는지 결정하는 데 도움이 됩니다.
스크립트 추가
더 고급 스킬의 경우 skill.md에 실행 가능한 코드 파일을 첨부하여 Claude가 코드를 실행할 수 있도록 합니다. 예를 들어, 당사의 문서 스킬은 다음 프로그래밍 언어 및 패키지를 사용합니다:
Python(pandas, numpy, matplotlib)
JavaScript/Node.js
파일 편집을 돕는 패키지
시각화 도구
참고: Claude 및 Claude Code는 스킬을 로드할 때 표준 저장소(Python PyPI, JavaScript npm)에서 패키지를 설치할 수 있습니다. API 스킬의 경우 런타임에 추가 패키지를 설치할 수 없습니다. 모든 종속성은 컨테이너에 사전 설치되어야 합니다.
스킬 패키징
스킬 폴더가 완성되면:
폴더 이름이 스킬의 이름과 일치하는지 확인합니다.
폴더의 ZIP 파일을 만듭니다.
ZIP은 스킬 폴더를 루트로 포함해야 합니다(하위 폴더 아님).
올바른 구조:
my-skill.zip
└── my-skill/
├── skill.md
└── resources/
잘못된 구조:
my-skill.zip
└── (ZIP 루트에 직접 파일)
스킬 테스트
업로드 전
1. 명확성을 위해 skill.md를 검토합니다.
2. 설명이 Claude가 스킬을 사용해야 할 시기를 정확하게 반영하는지 확인합니다.
3. 참조된 모든 파일이 올바른 위치에 있는지 확인합니다.
4. 예제 프롬프트로 테스트하여 Claude가 적절하게 호출하는지 확인합니다.
Claude에 업로드한 후
1. Customize > Skills에서 스킬을 활성화합니다.
2. 이를 트리거해야 하는 여러 가지 다른 프롬프트를 시도합니다.
3. Claude의 생각을 검토하여 스킬을 로드하는지 확인합니다.
4. Claude가 예상대로 사용하지 않는 경우 설명을 반복합니다.
Team 및 Enterprise 플랜 참고: 조직의 모든 사용자가 스킬을 사용할 수 있도록 하려면 조직을 위한 스킬 프로비저닝 및 관리를 참조하세요.
모범 사례
집중 유지: 다양한 워크플로우에 대해 별도의 스킬을 만듭니다. 여러 개의 집중된 스킬이 하나의 큰 스킬보다 더 잘 구성됩니다.
명확한 설명 작성: Claude는 설명을 사용하여 스킬을 호출할 시기를 결정합니다. 적용되는 시기를 구체적으로 명시합니다.
간단하게 시작: 복잡한 스크립트를 추가하기 전에 마크다운의 기본 지침으로 시작합니다. 나중에 언제든지 스킬을 확장할 수 있습니다.
예제 사용: skill.md 파일에 예제 입력 및 출력을 포함하여 Claude가 성공이 무엇인지 이해하도록 돕습니다.
증분 테스트: 복잡한 스킬을 한 번에 모두 구축하기보다는 각 중요한 변경 후에 테스트합니다.
스킬은 서로 구축할 수 있습니다: 스킬이 다른 스킬을 명시적으로 참조할 수는 없지만 Claude는 여러 스킬을 자동으로 함께 사용할 수 있습니다. 이 구성 가능성은 스킬 기능의 가장 강력한 부분 중 하나입니다.
개방형 Agent Skills 사양 검토: agentskills.io의 지침을 따르면 만드는 스킬이 표준을 채택하는 플랫폼 전체에서 작동할 수 있습니다.
스킬 생성에 대한 더 심층적인 가이드는 Claude Docs의 스킬 작성 모범 사례를 참조하세요.
보안 고려 사항
skill.md 파일에 스크립트를 추가할 때 주의를 기울이세요.
민감한 정보(API 키, 암호)를 하드코딩하지 마세요.
활성화하기 전에 다운로드한 스킬을 검토하세요.
외부 서비스 액세스를 위해 적절한 MCP 연결을 사용하세요.
참조할 예제 스킬
템플릿으로 사용할 수 있는 예제 스킬은 GitHub의 저장소를 방문하세요: https://github.com/anthropics/skills/tree/main/skills.