Custom Skills를 사용하면 조직이나 개인의 작업 스타일에 맞는 전문 지식과 워크플로우로 Claude를 향상시킬 수 있습니다. 이 문서에서는 자신만의 Skills를 만들고, 구조화하고, 테스트하는 방법을 설명합니다.
Skills는 몇 줄의 지침부터 실행 가능한 코드가 포함된 다중 파일 패키지까지 다양할 수 있습니다. 최고의 Skills는 다음과 같은 특징이 있습니다:
특정하고 반복 가능한 작업을 해결합니다
Claude가 따를 수 있는 명확한 지침이 있습니다
필요할 때 예제를 포함합니다
사용해야 할 시기를 정의합니다
모든 것을 하려고 하기보다는 하나의 워크플로우에 집중합니다
Skill.md 파일 만들기
모든 Skill은 최소한 Skill.md 파일을 포함하는 디렉토리로 구성되며, 이 파일이 Skill의 핵심입니다. 이 파일은 필수 메타데이터인 이름과 설명 필드를 포함하는 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
## 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 파일에 추가할 정보가 너무 많은 경우(예: 특정 시나리오에만 적용되는 섹션), Skill 디렉토리 내에 파일을 추가하여 콘텐츠를 추가할 수 있습니다. 예를 들어, Skill 디렉토리에 보충 및 참조 정보가 포함된 REFERENCE.md 파일을 추가합니다. 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 폴더를 루트로 포함해야 합니다(하