스킬은 Free, Pro, Max, Team 및 Enterprise 플랜의 사용자가 사용할 수 있습니다. 이 기능을 사용하려면 코드 실행이 활성화되어야 합니다. 스킬은 Claude Code 사용자와 코드 실행 도구를 사용하는 모든 API 사용자를 위해 베타 버전으로도 제공됩니다.
사용자 정의 스킬을 사용하면 조직이나 개인 작업 스타일에 맞는 전문 지식과 워크플로우로 Claude를 향상시킬 수 있습니다. 이 문서에서는 자신의 스킬을 만들고, 구조화하고, 테스트하는 방법을 설명합니다.
스킬은 몇 줄의 지시사항만큼 간단할 수도 있고, 실행 가능한 코드가 포함된 다중 파일 패키지만큼 복잡할 수도 있습니다. 최고의 스킬은:
특정하고 반복 가능한 작업을 해결합니다
Claude가 따를 수 있는 명확한 지시사항이 있습니다
도움이 될 때 예시를 포함합니다
사용해야 할 시기를 정의합니다
모든 것을 하려고 하기보다는 하나의 워크플로우에 집중합니다
스킬 기록
스킬 기록은 Mac용 Claude의 Cowork에서 Pro, Max 및 Team 플랜에서 사용할 수 있습니다. 채팅, Windows 또는 Free 및 Enterprise 플랜에서는 사용할 수 없습니다.
스킬을 직접 작성하는 대신 작업을 수행하는 것을 기록하고 Claude가 관찰한 내용으로부터 스킬을 구축하도록 할 수 있습니다. 화면, 클릭, 입력 및 음성의 비디오를 Claude에 보내면 Claude가 저장하기 전에 검토할 스킬을 제안합니다.
기록하기 전에
Mac용 Claude를 최신 버전으로 업데이트하세요.
처음 기록할 때 Claude가 요청하는 macOS 권한을 부여하세요: 마우스 및 키보드 추적을 위한 접근성, 화면 표시를 위한 화면 기록. macOS에서 Claude를 다시 시작하도록 요청할 수 있습니다.
캡처하지 않으려는 파일, 앱 또는 대화를 닫으세요.
경고: 기록 중에 비밀번호나 시크릿을 입력하거나 민감한 정보나 개인 대화를 표시하지 마세요. 화면의 모든 것이 세션 길이 동안 캡처되며, 말하는 모든 것도 함께 캡처됩니다.
워크플로우 기록
Mac용 Claude에서 Cowork를 열으세요.
다음 두 가지 방법 중 하나로 기록을 시작하세요:
작성기의 "+" 버튼을 클릭한 다음 "스킬 기록"을 선택하세요.
사용자 정의 > 스킬로 이동하여 "추가"를 클릭한 다음 "화면 기록"을 선택하세요.
"기록 시작"을 클릭하세요. 작업하면서 설명하려면 마이크를 켜두세요. 마이크 컨트롤을 사용하여 음소거하거나 다른 입력을 선택하세요.
평소처럼 작업을 수행하세요. 캡처 표시줄은 기록이 진행 중임을 보여주고 캡처한 단계를 계산합니다.
완료되면 "완료"를 클릭하거나 "취소"를 클릭하여 아무것도 만들지 않고 기록을 버리세요.
기록은 약 10분 동안 실행될 수 있습니다. 약 1분이 남았을 때 캡처 표시줄에 카운트다운이 나타납니다. 0에 도달하면 기록이 중지되고 캡처한 모든 내용이 Claude로 전송되며, 이는 "완료"를 클릭한 것과 같습니다.
팁: 기록하는 동안 하고 있는 일을 말로 설명하세요. 설명은 Claude가 화면만으로는 얻을 수 없는 컨텍스트를 제공합니다. 예를 들어 단계를 건너뛰는 이유나 두 옵션 중에서 선택하는 방법 등입니다.
완료를 클릭한 후 어떤 일이 발생합니까
Claude는 Cowork 작업을 시작하고 기록을 검토한 다음 스킬을 제안합니다. 발견한 내용에 따라 다음 두 가지 중 하나를 보게 됩니다:
새 스킬, 제안 카드에 새로 만들기로 표시됩니다. "저장"을 클릭하여 유지하거나 "해제"를 클릭하여 제안을 버리세요.
기존 스킬에 대한 업데이트. 기록이 이미 있는 스킬과 겹치면 Claude는 대신 해당 스킬에 대한 변경을 제안합니다. 카드는 제안이 기반한 스킬을 표시합니다. "업데이트"를 클릭하여 변경 사항을 적용하거나 "해제"를 클릭하여 버리세요.
제안 카드에서 콘텐츠를 확장하여 결정하기 전에 스킬을 읽으세요.
기록에서 저장한 스킬은 사용자 정의 > 스킬에 나타나며 다른 스킬처럼 작동합니다. 같은 조건으로 편집, 공유 및 삭제할 수 있습니다.
기록에서 유지되는 것
기록의 비디오 및 오디오는 보관되지 않습니다. 기록을 Claude에 보낸 후 Claude는 기록을 검토하여 스킬을 구축합니다. 그 후 저장되는 것은 세션의 스크린샷 집합이며, 작업에서 기록된 시연 단계를 확장하여 볼 수 있습니다.
이러한 스크린샷이 Cowork 작업에 있으므로 작업을 삭제하면 스크린샷이 제거됩니다. 작업 삭제 및 보관 방식에 대해서는 Claude Cowork 시작하기를 참조하세요.
skill.md 파일 만들기
모든 스킬은 최소한 skill.md 파일을 포함하는 디렉토리로 구성되며, 이는 스킬의 핵심입니다. 이 파일은 필수 메타데이터인 이름 및 설명 필드를 보유하기 위해 YAML 프론트매터로 시작해야 합니다. 또한 추가 메타데이터, Claude에 대한 지시사항 또는 참조 파일, 실행 가능한 스크립트 또는 도구를 포함할 수 있습니다.
필수 메타데이터 필드
name: 스킬의 사용자 친화적 이름(최대 64자)
예: 브랜드 가이드라인
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. 사용자 정의 > 스킬에서 스킬을 활성화합니다.
2. 이를 트리거해야 하는 여러 다른 프롬프트를 시도합니다.
3. Claude의 사고 과정을 검토하여 스킬이 로드되는지 확인합니다.
4. Claude가 예상대로 사용하지 않는 경우 설명을 반복합니다.
Claude와 채팅하면서 스킬을 반복할 때 대화 옆에 열리는 스킬 파일을 직접 편집할 수 있습니다. 변경하려는 텍스트를 강조 표시하고 "Claude로 편집"을 클릭한 후 요청을 입력합니다. 여러 파일이 있는 스킬의 경우 파일 전체에 편집 요청을 남기고 함께 보내면 Claude가 한 번에 적용합니다. 아티팩트 편집에 대해 자세히 알아보세요.
Team 및 Enterprise 플랜 사용자 참고: 조직의 모든 사용자가 스킬을 사용할 수 있도록 하려면 조직을 위한 스킬 프로비저닝 및 관리를 참조하세요.
모범 사례
집중력 유지: 다양한 워크플로우를 위해 별도의 스킬을 만듭니다. 여러 개의 집중된 스킬이 하나의 큰 스킬보다 더 잘 구성됩니다.
명확한 설명 작성: Claude는 설명을 사용하여 스킬을 호출할 시기를 결정합니다. 적용되는 시기를 구체적으로 명시합니다.
간단하게 시작: 복잡한 스크립트를 추가하기 전에 마크다운의 기본 지침으로 시작합니다. 나중에 언제든지 스킬을 확장할 수 있습니다.
예시 사용: skill.md 파일에 입력 및 출력 예시를 포함하여 Claude가 성공이 무엇인지 이해하도록 돕습니다.
증분 테스트: 복잡한 스킬을 한 번에 모두 구축하기보다는 각 중요한 변경 후에 테스트합니다.
스킬은 서로 기반이 될 수 있습니다: 스킬이 다른 스킬을 명시적으로 참조할 수는 없지만 Claude는 여러 스킬을 자동으로 함께 사용할 수 있습니다. 이러한 구성 가능성은 스킬 기능의 가장 강력한 부분 중 하나입니다.
공개 Agent Skills 사양 검토: agentskills.io의 가이드라인을 따르면 생성한 스킬이 표준을 채택한 플랫폼 전체에서 작동할 수 있습니다.
스킬 생성에 대한 더 자세한 가이드는 Claude 문서의 스킬 작성 모범 사례를 참조하세요.
보안 고려 사항
skill.md 파일에 스크립트를 추가할 때 주의를 기울이세요.
민감한 정보(API 키, 비밀번호)를 하드코딩하지 마세요.
다운로드한 스킬을 활성화하기 전에 검토하세요.
외부 서비스 접근을 위해 적절한 MCP 연결을 사용하세요.
참조할 예제 스킬
GitHub의 저장소를 방문하여 템플릿으로 사용할 수 있는 예제 스킬을 확인하세요: https://github.com/anthropics/skills/tree/main/skills.