스킬은 Free, Pro, Max, Team, Enterprise 플랜의 사용자가 이용할 수 있습니다. 이 기능을 사용하려면 코드 실행이 활성화되어야 합니다. 스킬은 Claude Code 사용자와 코드 실행 도구를 사용하는 모든 API 사용자를 위해 베타 버전으로도 제공됩니다.
맞춤형 스킬을 사용하면 조직이나 개인의 작업 스타일에 맞는 전문 지식과 워크플로우로 Claude를 강화할 수 있습니다. 이 문서에서는 자신만의 스킬을 만들고, 구조화하고, 테스트하는 방법을 설명합니다.
스킬은 몇 줄의 지시사항만큼 간단할 수도 있고, 실행 가능한 코드가 포함된 다중 파일 패키지만큼 복잡할 수도 있습니다. 최고의 스킬은:
특정하고 반복 가능한 작업을 해결합니다
Claude가 따를 수 있는 명확한 지시사항이 있습니다
도움이 될 때 예시를 포함합니다
사용해야 할 시기를 정의합니다
모든 것을 하려고 하기보다는 하나의 워크플로우에 집중합니다
스킬 기록하기
스킬 기록은 Pro, Max, Team 플랜에서 Mac용 Claude의 Cowork에서 사용할 수 있습니다. 채팅, 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는 설명을 사용하여 스킬을 호출할 시기를 결정합니다. 적용되는 시기를 구체적으로 명시합니다.
간단하게 시작: 복잡한 스크립트를 추가하기 전에 Markdown의 기본 지침으로 시작합니다. 나중에 언제든지 스킬을 확장할 수 있습니다.
예제 사용: skill.md 파일에 입력 및 출력 예제를 포함하여 Claude가 성공이 무엇인지 이해하도록 도와줍니다.
증분 테스트: 한 번에 복잡한 스킬을 구축하기보다는 각 중요한 변경 후에 테스트합니다.
스킬은 서로 기반이 될 수 있습니다: 스킬이 다른 스킬을 명시적으로 참조할 수는 없지만, Claude는 여러 스킬을 자동으로 함께 사용할 수 있습니다. 이러한 구성 가능성은 스킬 기능의 가장 강력한 부분 중 하나입니다.
공개 Agent Skills 사양 검토: agentskills.io의 가이드라인을 따르면 만든 스킬이 표준을 채택하는 플랫폼 전체에서 작동할 수 있습니다.
스킬 생성에 대한 더 자세한 가이드는 Claude 문서의 스킬 작성 모범 사례를 참조하세요.
보안 고려 사항
skill.md 파일에 스크립트를 추가할 때 주의하세요.
민감한 정보(API 키, 비밀번호)를 하드코딩하지 마세요.
활성화하기 전에 다운로드한 모든 스킬을 검토하세요.
외부 서비스 액세스를 위해 적절한 MCP 연결을 사용하세요.
참조할 예제 스킬
템플릿으로 사용할 수 있는 예제 스킬을 보려면 GitHub의 저장소를 방문하세요: https://github.com/anthropics/skills/tree/main/skills.