스킬 생성 방법: 주요 단계, 제한 사항, 예시

스킬은 특정 업무나 전문 영역에 맞게 Claude의 역량을 확장하는 맞춤형 지침입니다. 

SKILL.md 파일을 통해 스킬을 생성하면, Claude가 특정 시나리오를 더욱 효과적으로 처리하는 방식을 학습하게 됩니다. 스킬의 강점은 조직의 노하우를 구조화해 반영하고, 결과물을 표준화하며, 반복적인 설명이나 별도의 커스텀 에이전트 구축에 대한 투자 없이도 복잡한 다단계 워크플로우를 처리할 수 있다는 데 있습니다.

Skill Creator 템플릿이나 수동 방식을 활용해 Claude를 범용 어시스턴트에서 특정 워크플로우에 특화된 전문가로 전환하는 방법을 알아보세요. (프로 팁: 이 템플릿으로 SKILL.md 파일을 먼저 생성한 뒤, 필요에 맞게 조정하면 더 수월합니다.)

5단계로 스킬 만들기

이 체계적인 접근 방식을 따르면, 스킬이 보다 안정적으로 트리거되도록 설계할 수 있습니다.

1. 핵심 요구 사항 이해하기

스킬을 작성하기 전에, 이 스킬이 해결해야 할 문제를 명확히 정의해야 합니다. 효과적인 스킬은 결과를 측정할 수 있는 구체적인 요구를 충족합니다. 'PDF에서 재무 데이터를 추출해 CSV 형식으로 변환해 줘'는 입력 형식, 처리 방식, 예상 출력 결과가 명확하지만, '재무 관련 일을 도와줘'는 그렇지 않습니다.

먼저 다음 질문부터 스스로에게 던져보세요: 이 스킬이 수행해야 할 구체적인 작업은 무엇인가요? 어떤 트리거에 의해 이 스킬이 실행되어야 할까요? 성공의 기준은 무엇인가요? 예외 상황이나 한계는 무엇인가요?

2. 이름 정하기

스킬은 이름(명확한 식별자), 설명(활성화 시기), 지침(실행 방법)이라는 세 가지 핵심 구성 요소가 필요합니다. 실제로, 이름과 설명은 SKILL.md 파일에서 트리거에 영향을 미치는 유일한 요소로, Claude가 전문 지식이나 워크플로우를 위해 스킬을 호출할 수 있는지를 결정합니다. 

이름은 직관적이고 의미가 분명하게 드러나야 합니다. 소문자와 하이픈을 사용해 작성하고(예: pdf-editor, 브랜드-가이드라인), 간결하고 명확하게 유지하세요.

3. 설명 필드 작성하기

설명은 스킬이 언제 활성화될지 결정하는 가장 중요한 구성 요소입니다. Claude의 관점에서 트리거, 기능, 사용 사례에 중점을 두고 작성해야 합니다.

효과적인 설명은 구체적인 기능, 명확한 트리거, 관련 맥락, 범위와 같은 여러 요소를 균형 있게 포함합니다.

비효율적인 설명:

효과적인 설명:

잘 작성된 설명은 Claude에 여러 분석 포인트를 제공합니다. 여기에는 구체적인 동사(추출, 생성, 병합), 명확한 사용 사례(양식 작성, 일괄 처리), 분명한 범위(단순 열람 제외) 등이 포함됩니다.

4. 주요 지침 작성하기

지침은 구조화되어 있고, 빠르게 파악할 수 있으며, 실행 가능해야 합니다. Markdown 헤더를 사용하고, 선택 항목은 불릿으로, 예제는 코드 블록으로 제시하세요.

개요, 전제 조건, 실행 단계, 예시, 오류 처리, 제한 사항 순으로 명확한 계층 구조를 따르는 것이 효과적입니다. 복잡한 워크플로우는 입력과 출력이 명확한 단계로 구분해 설명합니다.

올바른 사용법을 보여주는 구체적인 예시를 포함하세요. 오용을 방지하고 기대치를 관리하기 위해 스킬이 지원하지 않는 범위를 명시해야 합니다. 또한 SKILL.md 파일에 추가 참조 파일과 자산을 포함해, 스킬이 트리거될 때 에이전트 동작에 대한 지침을 더욱 명확히 제공할 수 있습니다.

5. 스킬 업로드하기 

스킬 업로드 방식은 Claude를 사용하는 환경에 따라 다릅니다. 

• Claude.ai(Claude 앱): 설정에서 사용자 지정 스킬을 추가합니다. 사용자 지정 스킬은 코드 실행이 활성화된 Pro, Max, Team 또는 Enterprise 플랜에서만 사용 가능합니다. 이 방식으로 업로드된 스킬은 각 사용자마다 개별적으로 적용되며, 조직 단위 공유나 관리자 중앙 관리는 불가능합니다.
• Claude Code: 플러그인 또는 프로젝트 루트에 skills/ 디렉토리를 생성하고, SKILL.md 파일이 포함된 스킬 폴더를 추가합니다. 플러그인이 설치되면 Claude가 해당 스킬을 자동으로 검색해 활용합니다. 예제 구조:

• Claude Developer Platform: Skills API(/v1/skills 엔드포인트)를 통해 스킬을 업로드합니다. 필요한 베타 헤더를 포함한 POST 요청을 사용하세요.

4. 테스트 및 검증하기

스킬을 배포하기 전에 현실적인 시나리오를 기반으로 테스트하세요. 체계적인 테스트를 통해, 지침의 결함, 설명의 모호함, 그리고 실제 사용 중에만 나타나는 예상치 못한 문제 상황을 파악할 수 있습니다.

다음 세 가지 시나리오를 포함하는 테스트 매트릭스를 구성하세요.

• 정상 작동: 스킬을 정상적으로 처리해야 하는 일반적인 요청을 기준으로 테스트합니다. 재무 분석 스킬을 만들었다면, 'Microsoft의 최신 실적을 분석해 줘' 또는 '이 10-K 문서에 대한 데이터팩을 생성해 줘'와 같은 요청을 사용하세요. 이러한 기본 테스트를 통해 지침이 의도대로 작동하는지 확인할 수 있습니다.
• 특이 케이스: 불완전하거나 비정상적인 입력으로 테스트합니다. 데이터가 누락되면 어떤 상황이 발생하는지, 파일 형식이 예상과 다를 때 어떻게 되는지, 사용자가 모호한 지침을 제공했을 때 어떻게 되는지 등을 확인합니다. 스킬은 이러한 상황도 안정적으로 처리해야 하며, 출력 품질이 낮아지더라도 유용한 결과를 제공하거나, 다음 단계로 진행하기 위해 필요한 정보를 안내해야 합니다.
• 범위 외 요청: 관련성이 있는 것처럼 보이지만 실제로는 스킬이 트리거되지 않아야 하는 작업으로 테스트합니다. NDA 검토 스킬을 만들었다면, '이 근로 계약서를 검토해 줘' 또는 '이 임대차 계약서를 분석해 줘'와 같은 요청을 활용하세요. 이 경우 스킬은 비활성 상태로 유지되고, 다른 스킬이나 Claude의 일반 기능이 해당 요청을 처리하도록 해야 합니다.

보다 심층적인 검증을 위해 다음 테스트를 추가로 수행해 보세요.

• 트리거 테스트: 스킬이 기대한 시점에 활성화되나요? 명시적인 요청("이 회사 분석에 재무 데이터팩 스킬을 사용해 줘")과 자연스러운 요청("이 회사의 재무 상태를 파악할 수 있도록 도와줘")을 모두 활용해 테스트를 진행하세요. 관련성이 없을 때는 비활성 상태를 유지하나요? 범위가 적절하게 설정된 스킬은 활성화되지 않아야 하는 조건을 명확히 인지합니다. 유사하지만 차별화된 요청을 테스트해 스킬의 범위를 검증하세요.
• 기능 테스트: 여기에는 출력 일관성(유사한 입력으로 여러 차례 실행했을 때 비교 가능한 결과를 얻었는가?), 사용성(해당 분야에 익숙하지 않은 사용자도 성공적으로 사용할 수 있는가?), 문서 정확성(예시가 실제 동작과 일치하는가?)이 포함됩니다. 

5. 실사용 기반으로 반복하기

실제 사용 환경에서 스킬이 어떻게 동작하는지 모니터링하세요. 트리거가 일관되지 않으면 설명을 정교하게 다듬고, 결과가 예기치 않게 달라지면 지침을 명확하게 수정해야 합니다. 프롬프트와 마찬가지로, 가장 효과적인 스킬은 실사용을 거치며 점진적으로 진화합니다.

스킬 생성을 위한 일반적인 모범 사례

이러한 원칙은 단순한 이론이 아니라, 유지 보수 가능하고, 재사용할 수 있으며, 실제로 유용한 스킬을 만드는 데 도임이 됩니다.

사용 사례부터 시작하기

스킬 추측에 기반해 만드는 것이 아니라, 실제로 반복되는 작업이 있을 때 만들어야 합니다. 가장 효과적인 기술은 정기적으로 마주치는 문제를 해결합니다.

스킬을 만들기 전에 다음 질문을 검토해 보세요: 이 작업을 최소 5회 이상 수행했나요? 앞으로도 최소 10회 이상 더 수행하게 될 작업인가요? 두 질문에 모두 '예'라면 스킬을 만드는 것이 합리적입니다.

성공 기준을 정의하여 스킬에 반영하기

Claude에게 무엇이 좋은 결과인지 알려주세요. 예를 들어 재무 보고서를 생성한다면, 필요한 섹션, 서식 표준, 유효성 검사, 품질 임계값을 구체적으로 명시하는 것이 좋습니다. 이러한 기준을 지침에 포함하면 Claude가 스스로 검증할 수 있습니다.

Skill-Creator 스킬 사용

skill-creator 스킬은 구조가 체계적인 스킬을 만들 수 있도록 안내합니다. 설명을 명확히 하기 위한 질문을 제시하고, 더 나은 설명을 제안하며, 지침을 올바른 형식으로 구성하도록 지원합니다. GitHub의 Skills 리포지토리와 Claude.ai를 통해 사용할 수 있으며, 스킬 작성을 처음 시작할 때 특히 유용합니다.

스킬 제한 사항 및 고려 요소

스킬 작동 방식과 그 범위를 이해하면 더 효과적인 스킬을 설계하고, 적절한 기대치를 설정하는 데 도움이 됩니다.

스킬 트리거 방식 이해하기

Claude는 요청을 스킬 설명과 대조해 관련성을 판단합니다. 이 과정에서 Claude는 키워드를 매칭시키는 것이 아니라 의미적 연관성을 이해합니다. 하지만 설명이 모호할수록 트리거 정확도가 저하됩니다.

복잡한 작업의 경우, 다양한 측면을 다루는 여러 스킬이 동시에 활성화될 수 있습니다. 설명이 지나치게 일반적이면 불필요한 스킬 활성화를 유발하고, 사용 사례가 누락되어 있으면 활성화되어야 할 상황을 놓칠 수도 있습니다.

적절한 파일 크기 유지하기

스킬을 작성할 때는 불필요한 내용으로 컨텍스트 창을 늘리지 않도록 주의하세요. 각 정보가 항상 로드되어야 하는지, 아니면 특정 조건에서만 로드되어야 하는지 고려해야 합니다.

스킬이 여러 개의 프로세스나 옵션을 다룬다면 '메뉴' 방식을 사용하는 것이 좋습니다. SKILL.md에는 사용 가능한 기능을 나열하고, 각 기능에 대해 별도의 파일을 참조할 수 있도록 상대 경로를 사용하세요. 이렇게 하면 Claude는 사용자의 작업과 관련된 파일만 읽고, 나머지 파일은 해당 대화에서 로드하지 않습니다.

별도의 파일들이 완전히 배타적인 경로를 의미할 필요는 없습니다. 핵심 원칙은 콘텐츠를 적절한 단위로 나누고, Claude가 현재 작업에 따라 필요한 정보만 선택하도록 하는 것입니다.

­실제 스킬 예시

스킬 예시 1: docx 생성 스킬

이 스킬이 효과적인 이유: 작업 유형에 따라 Claude를 적절한 워크플로우로 안내하는 명확한 의사결정 구조를 갖추고 있으며, 점진적 공개를 통해 메인 파일은 간결하게 유지하면서 필요할 때만 상세 구현 파일을 참조합니다. 또한 변경 추적과 같이 복잡한 패턴에 대해 구현 방식을 정확히 보여주는 올바른 예시와 잘못된 예시를 포함합니다.

스킬 예시 2: 브랜드 가이드라인

이 스킬이 효과적인 이유: Claude가 내재적으로 갖지 않은 정확하고 실행 가능한 정보(예: 정확한 HEX 코드, 폰트명, 크기 기준)를 제공하며, 스킬이 무엇을 수행하고, 어떤 조건에서 트리거되는지 명확하게 설명합니다.

이 스킬이 효과적인 이유: 명확한 경계를 갖춘 창의적 기능을 제공하고, 저작권 보호를 기본적으로 고려하며, 비음악가를 위한 기술적 기반과 품질 기준을 제시합니다.

스킬 예시 3: 프론트엔드 디자인 스킬

이 스킬이 효과적인 이유: 명확한 경계를 갖춘 창의적 기능을 제공하고, 저작권 보호를 기본적으로 고려하며, 비음악가를 위한 기술적 기반과 품질 기준을 제시합니다.

자주 묻는 질문

설명이 실제로 트리거되게 하려면 어떻게 작성해야 하나요?

일반적인 키워드 대신에 기능과 시나리오에 집중하세요. 동작 동사, 구체적인 파일 유형, 명확한 사용 사례를 포함해야 합니다. 예를 들어, '문서 처리 스킬'보다는 '데이터 분석 워크플로우를 위해 PDF에서 표를 추출하고 CSV 형식으로 변환'이 효과적입니다.

Claude는 어떤 스킬을 사용할지 어떻게 판단하나요?

Claude는 사용자의 요청을 스킬 설명과 대조해 의미적 이해를 기반으로 평가합니다. 이는 키워드 매칭이 아니라, Claude가 맥락적 관련성을 판단하는 방식입니다. 요청에 다양한 측면이 포함된 경우에는 여러 스킬을 활성화할 수 있습니다.

설명은 어느 정도로 세분화해야 하나요?

하나의 목적을 가진 스킬을 목표로 삼아야 합니다. '블로그 게시물을 위한 SEO 최적화'는 구체적인 지침을 담을 수 있을 만큼 명확하면서도, 재사용이 가능한 적절한 범위입니다. '콘텐츠 마케팅 도우미'는 범위가 너무 포괄적이고, '메타 설명 추가'는 지나치게 좁은 범위에 해당합니다.

조직 차원에서 스킬을 어떻게 공유하나요?

팀 규모와 관계없이, 스킬 사양이 포함된 공유 문서 리포지토리를 구축하는 것이 좋습니다. 

소규모 팀의 경우, 이름, 설명, 지침, 버전 정보가 포함된 템플릿 형식을 사용하세요.

중대형 팀의 경우, 다음과 같은 스킬 거버넌스 프로세스를 수립하세요.

• 스킬 영역별(예: 재무, 법률, 마케팅) 담당자 지정
• 중앙 위키(공용 문서 허브) 또는 공유 드라이브를 스킬 라이브러리로 운영
• 각 스킬의 사용 사례와 일반적인 문제 해결 방법 포함
• 스킬 버전 관리 및 변경 로그 문서화
• 분기별 정기 검토로 스킬 업데이트 또는 불필요한 스킬 정리

모든 규모의 팀에 적용되는 사례:

• 각 스킬의 비즈니스 목적을 문서화
• 유지 보수 및 업데이트를 위한 명확한 책임자 지정
• 신입 팀원에게 공유 스킬 구현 방법을 안내하는 온보딩 자료 작성
• 가장 높은 가치를 제공하는 스킬을 추적하여 관리 우선순위 결정
• 스킬을 쉽게 찾을 수 있도록 일관된 명명 규칙 적용

엔터프라이즈 고객은 Anthropic의 고객 성공 팀과 협력하여 추가 배포 옵션과 거버넌스 프레임워크를 검토할 수 있습니다.

스킬은 어떻게 디버깅하나요?

트리거와 실행을 별도로 테스트하세요. 스킬이 활성화되지 않는다면 설명 범위를 넓히고 사용 사례를 추가하세요. 결과가 일관되지 않다면 지침을 구체화하고, 검증 단계를 포함해야 합니다. 정상 사용, 특이 케이스, 범위 외 요청을 포함하는 테스트 케이스 라이브러리를 구축하세요.

조직 차원에서 스킬을 어떻게 공유하나요?

Claude.ai에서는 현재 스킬이 사용자별로 개별 지원되며, 조직 차원의 관리 및 공유 기능은 곧 제공될 예정입니다. 그 전까지는 팀 규모와 관계없이, 스킬 사양이 포함된 공유 문서 리포지토리를 구축하는 것이 좋습니다.  이는 조직이 향후 기능 도입을 준비하는 동시에, 지금부터 거버넌스 모범 사례를 수립하는 데 도움이 됩니다.

시작하기

스킬을 활용할 준비가 되셨나요? 시작 방법은 다음과 같습니다.

Claude.ai 사용자:

• 설정 → 기능에서 스킬 활성화
• Claude.ai/projects에서 첫 번째 프로젝트 생성
• 다음 분석 작업에서 프로젝트 지식과 스킬 결합해서 활용

API 개발자:

• 문서에서 Skills endpoint 살펴보기
• Skills Cookbook 확인

Claude Code 사용자:

• 플러그인 마켓플레이스를 통해 Skills 설치
• Skills Cookbook 확인