클로드 스킬 제작 실용 가이드: 구조, 트리거, 스크립트

클로드 스킬이 무엇이며 어떻게 작동하는가

클로드 스킬은 특정 작업을 자동화하는 지침 매뉴얼로, 프로젝트(지식 베이스)나 모델 컨텍스트 프로토콜(실시간 데이터 연결 계층)과는 구분됩니다. 세 번 이상의 대화 시작 부분에서 동일한 지침을 타이핑한 적이 있다면, 그것은 만들어야 할 스킬입니다.

스킬 구조와 설정

스킬은 SKILL.md라는 하나의 파일을 포함하는 폴더입니다. 기본 구조는 다음과 같습니다:

your-skill-name/
├── SKILL.md
└── references/
    └── your-ref.md

이 폴더를 당신의 컴퓨터에 있는 ~/.claude/skills/ 디렉토리에 넣으세요. 클로드가 자동으로 찾습니다.

YAML 트리거: 활성화 메커니즘

SKILL.md 상단에, 클로드에게 언제 활성화할지 알려주기 위해 --- 줄 사이에 메타데이터를 작성하세요. 예시:

---
name: csv-cleaner
description: 지저분한 CSV 파일을 깔끔한 스프레드시트로 변환합니다. 사용자가 '이 CSV 정리해 줘', '헤더 고쳐 줘', '이 데이터 포맷팅해 줘', '이 스프레드시트 정리해 줘'라고 말할 때마다 이 스킬을 사용하세요. PDF, 워드 문서, 이미지 파일에는 사용하지 마세요.
---

세 가지 규칙을 따르세요: 3인칭으로 작성하세요, 정확한 트리거 구문을 나열하세요, 부정적 경계를 설정하세요. 설명 필드는 전체 스킬에서 가장 중요한 한 줄입니다—약한 설명은 스킬이 절대 발동하지 않음을 의미합니다.

지침만으로 부족할 때: 스크립트 디렉토리

평범한 영어 지침은 판단, 언어, 포맷팅, 결정을 처리합니다. 실제 계산이 필요한 작업의 경우, scripts/ 폴더를 추가하세요.

지침을 사용하는 경우: "이걸 우리 브랜드 음성으로 다시 써 줘" 또는 "이 회의록을 분류해 줘."

스크립트를 사용하는 경우: "이 숫자들의 이동 평균을 계산해 줘," "이 XML을 파싱해서 특정 필드를 추출해 줘," 또는 "이 폴더의 모든 이미지를 800x600으로 리사이즈해 줘."

둘 다 사용하는 스킬의 폴더 구조:

data-analyser/
├── SKILL.md
├── references/
│   └── analysis-template.md
└── scripts/
    ├── parse-csv.py
    └── calculate-stats.py

SKILL.md 내부에서, 스크립트를 다음과 같이 참조하세요:

## 워크플로우
1. 업로드된 CSV 파일을 읽어 구조를 이해합니다.
2. scripts/parse-csv.py를 실행하여 데이터를 정리합니다:
   - 명령어: `python scripts/parse-csv.py [input_file] [output_file]`
   - 이 작업은 빈 행을 제거하고, 헤더를 정규화하며, 데이터 타입을 강제합니다.
3. 정리된 데이터에 scripts/calculate-stats.py를 실행합니다:
   - 명령어: `python scripts/calculate-stats.py [cleaned_file]`
   - 이 작업은 각 숫자 열에 대한 평균, 중앙값, 표준 편차, 이상치를 출력합니다.
4. 통계적 출력을 읽고 references/analysis-template.md의 템플릿을 따라 사람이 읽기 쉬운 요약을 작성합니다. 비기술적 독자가 걱정할 만한 이상이나 이상치를 강조합니다.

스크립트는 계산을 처리하고, 지침은 판단을 처리합니다. 스크립트에 대한 한 가지 규칙: 하나의 스크립트, 하나의 작업. parse-csv.py는 통계도 계산해서는 안 됩니다. 집중적으로 유지하고, 파일 경로를 인수로 받아들이고, 절대 경로를 하드코딩하지 말고, 항상 오류 처리를 포함시켜 클로드가 실패를 읽고 깔끔하게 전달할 수 있게 하세요.

참조: 한 단계 깊이 규칙

스킬에 브랜드 가이드나 템플릿이 필요한 경우, references/에 넣고 SKILL.md에서 링크하세요. 절대 참조 파일이 다른 참조 파일을 링크하지 마세요—클로드가 읽기를 중단하고 내용을 놓칠 것입니다. 한 단계 깊이만 허용됩니다.

your-skill-name/
├── SKILL.md
└── references/
    └── brand-voice-guide.md ← SKILL.md에서 이 파일을 링크하세요 ← 여기서 다른 파일을 절대 링크하지 마세요

SKILL.md에서: 작업을 시작하기 전에 references/brand-voice-guide.md의 브랜드 음성 가이드를 읽으세요

다중 스킬 오케스트레이션: 충돌 방지

다섯 개 이상의 스킬을 배포하면, 브랜드 음성 강제 스킬이 이메일 작성 스킬을 원했을 때 발동하는 것과 같은 충돌이 시작됩니다. 이를 막는 세 가지 규칙:

• 규칙 1: 겹치지 않는 영역. 모든 스킬은 명확히 정의된 도메인을 소유합니다(예: 브랜드 음성 강제 스킬은 음성 준수를 처리하고, 이메일 작성 스킬은 구성물을 처리하며, 콘텐츠 재구성 스킬은 포맷 변환을 처리합니다). 침범 없음.
• 규칙 2: 공격적인 부정적 경계.