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

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

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

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

5단계로 Skill 만들기

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

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

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

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

2. 이름 정하기

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

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

3. 설명 필드 작성하기

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

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

비효율적인 설명:

효과적인 설명:

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

4. 주요 지침 작성하기

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

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

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

5. Skill 업로드하기 

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

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

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

4. 테스트 및 검증하기

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

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

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

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

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

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

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

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

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

사용 사례부터 시작하기

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

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

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

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

Skill-Creator Skill 사용

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

Skill 제한 사항 및 고려 요소

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

Skill 트리거 방식 이해하기

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

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

적절한 파일 크기 유지하기

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

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

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

­실제 Skill 예시

Skill 예시 1: docx 생성 Skill

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

Skill 예시 2: 브랜드 가이드라인

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

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

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

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

자주 묻는 질문

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Skill은 어떻게 디버깅하나요?

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

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

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

시작하기

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

Claude.ai 사용자:

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

API 개발자:

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

Claude Code 사용자:

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