Skill Creator

• 새로운 스킬을 처음부터 만들기 — 재사용 가능한 스킬로 패키징하고 싶은 도메인, 워크플로우 또는 툴 통합이 있으며, 구조, 콘텐츠 및 모범 사례에 대한 안내가 필요합니다.
• 기존 스킬 개선하기 — 안정적으로 트리거되지 않거나, 컨텍스트 윈도우를 부풀리거나, 유용한 번들 리소스가 부족한 스킬이 있어 원칙에 입각한 검토를 원합니다.
• 스킬 아키텍처 설계하기 — SKILL.md, scripts/, references/, assets/ 간에 콘텐츠를 어떻게 나눌지 확신이 없으며, 그러한 결정을 내리기 위한 프레임워크를 원합니다.
• 스킬 패키징 및 배포하기 — 스킬 디렉토리를 검증하고 공유를 위한 .skill 파일로 번들링할 준비가 되어 있습니다.

• 기존 스킬을 사용하기만 원하는 경우 — 이 스킬은 도메인 작업에서 스킬을 사용하기 위한 것이 아니라, 스킬을 생성하기 위한 것입니다.
• 작업이 일회성인 경우 — Claude가 특정 작업을 한 번만 수행하면 되고 재사용할 의도가 없다면, 전체 스킬 패키지를 만드는 것은 과한 조치입니다.

Claude가 반복 가능한 프로세스를 따라 진행할 수 있도록 안내합니다: 구체적인 예시를 통해 스킬 이해하기, 재사용 가능한 콘텐츠 계획하기, 디렉토리 초기화하기, SKILL.md 및 리소스 편집하기, 스킬 패키징하기, 그리고 반복 개선하기. 각 단계에는 명확한 진입/종료 기준이 있어 정당한 이유 없이 건너뛰는 일이 없도록 합니다.

스킬은 세 가지 수준의 로딩 시스템을 사용합니다 — 메타데이터 (약 100단어, 항상 컨텍스트에 포함), SKILL.md 본문 (트리거 시 로드되며 500줄 이내로 유지), 그리고 번들 리소스 (필요할 때만 로드). 이 스킬은 여러분이 이 원칙을 적용하여 스킬을 간결하고 컨텍스트 효율적으로 유지할 수 있도록 가르쳐 줍니다.

Claude에게 높은 자유도(개방형 텍스트 지침), 중간 자유도(매개변수가 있는 의사 코드), 또는 낮은 자유도(최소한의 변형만 허용하는 구체적인 스크립트)를 부여할 시기를 설명합니다. 작업의 취약성에 맞게 구체성을 조정하는 것은 Skill Creator에서 효과적인 스킬을 작성하는 핵심입니다.

세 가지 리소스 유형을 다룹니다 — 결정론적 실행 코드를 위한 scripts/, 필요 시 로드되는 문서를 위한 references/, 템플릿 및 이미지와 같은 출력 파일을 위한 assets/. 각 유형이 적절한 경우에 대한 구체적인 예시와 지침을 제공합니다.

init_skill.py를 사용하여 적절한 프론트매터, 자리 표시자 지침 및 예제 리소스 폴더를 포함한 새 스킬 디렉토리를 스캐폴딩합니다. package_skill.py를 사용하여 구조를 검증하고, 설명 품질을 확인하며, 배포 가능한 .skill 압축 파일을 생성합니다.

description 필드는 주요 트리거 메커니즘으로, 스킬이 무엇을 하는지 그리고 언제 사용해야 하는지를 명확하게 명시해야 합니다. 이 스킬은 올바른 시점에 올바른 스킬을 안정적으로 트리거하는 description 작성을 위한 명시적인 지침과 예시를 제공합니다.

한 팀이 내부 데이터베이스 스키마, API 사양, 비즈니스 정책을 활용하여 Claude가 질문에 답변하도록 하고자 합니다. Skill Creator를 사용하여 도메인별로 분리된 파일(finance.md, sales.md)이 포함된 references/ 디렉토리를 계획하고, 집중적인 SKILL.md를 작성한 후, 팀 배포를 위해 패키지로 묶습니다.

사용자가 Claude에게 PDF 회전, 텍스트 추출, 양식 작성 등을 자주 요청합니다. Skill Creator는 반복되는 코드를 파악하고, scripts/rotate_pdf.py를 생성하며, Claude가 언제 어떻게 이를 사용할지 알려주는 SKILL.md를 작성하도록 안내합니다. 이를 통해 매 세션마다 중복되는 코드 생성을 없앨 수 있습니다.

한 개발자가 Claude가 항상 일관된 React 보일러플레이트에서 새 웹 앱을 시작하기를 원합니다. Skill Creator는 개발자가 템플릿을 assets/hello-world/에 저장하고, 매번 보일러플레이트를 처음부터 작성하는 대신 Claude가 이를 복사하여 수정하도록 지시하는 안내문을 작성할 수 있도록 안내합니다.

기존 스킬이 예상대로 호출되지 않고 있습니다. Skill Creator의 프론트매터 설명에 관한 안내 — 특히 "언제 사용할지"에 대한 모든 맥락을 본문이 아닌 description 필드에 작성하는 것 — 가 트리거 문제를 진단하고 수정하는 데 도움이 됩니다.