Claude Skill 만드는 방법

Claude Skill 구축을 안내하는 역할을 하며, Skill이 로드될지 여부를 결정하는 필드는 트리거로 작성된 SKILL.md 프런트매터의 description입니다. 빈 폴더에서 작동하는 Skill을 완성할 때까지 사용자를 안내하도록 활성화되었습니다.

Claude 스킬을 만드는 방법 처음 만든 스킬 대부분은 실행되지 않습니다. 폴더는 올바른 위치에 있고, 내부 지침도 완벽하게 작성했는데 Claude가 아예 무시하는 이유는 스킬을 불러올지 결정하는 필드 하나를 트리거가 아닌 라벨로 작성했기 때문입니다. 이 가이드는 빈 폴더에서 시작해, 스킬이 존재한다는 사실을 기억하지 않아도 필요한 순간 자동으로 로드되는 스킬을 만드는 방법을 안내합니다. 스킬이란 무엇이며, 저장된 prompt보다 나은 이유 저장된 prompt는 복사해 붙여 넣는 것을 기억해야만 도움이 됩니다. 스킬은 다릅니다. 스킬은 Claude가 스스로 찾아서 로드할 수 있는 지침이 담긴 폴더이며, 사용자가 작성한 설명과 요청 내용을 비교해 일치할 때 실행됩니다. 설치가 끝나면 스킬의 존재를 더 이상 의식할 필요가 없습니다. 작업을 요청하기만 하면 되고, 요청이 일치할 경우 스킬의 지침이 Claude가 해당 요청을 처리하는 방식의 일부가 됩니다. 따라서 반복 보고서 형식, 특정 코드 리뷰 체크리스트, 문서를 항상 재구성하는 방식처럼 같은 방법으로 두 번 이상 수행하는 작업이라면 스킬로 만들 가치가 있습니다. 폴더 구조 스킬은 최소한 SKILL.md 파일 하나를 포함하는 폴더입니다. 폴더 이름은 SKILL.md의 내용만큼 중요하지 않지만, 일반적인 이름 대신 스킬의 역할을 구체적으로 나타내는 이름을 지정하세요. 참고 문서, 스크립트, 템플릿 같은 지원 파일은 같은 폴더에 SKILL.md와 함께 두고, SKILL.md 안에서 참조합니다. 스킬에 실제로 필요한 파일만 폴더에 포함하세요. 관련 없는 파일이 있으면 Claude가 읽어야 할 내용에 불필요한 잡음이 추가됩니다. SKILL.md와 프런트매터 SKILL.md는 최소한 name과 description을 포함하는 프런트매터 블록(--- 줄 사이에 작성)으로 시작합니다. Claude는 현재 요청과 이 스킬이 관련 있는지 판단할 때 전체 본문이 아니라 프런트매터를 확인합니다. 프런트매터를 잘못 작성하면 Claude가 본문을 로드하지 않으므로, 본문의 품질은 아무런 의미가 없습니다. name: 짧은 식별자이며, 소문자와 하이픈으로 작성합니다. 스킬을 참조할 때 사용하며, 트리거 역할을 하지는 않습니다. description: 스킬 전체에서 가장 중요한 한 줄입니다. Claude는 이 내용을 사용자가 실제로 한 요청과 비교해 스킬을 로드할지 결정합니다. 실제로 실행되는 description 작성법 가장 흔한 실수는 description을 트리거가 아니라 라벨로 작성하는 것입니다. 라벨은 스킬이 무엇인지 설명합니다. 트리거는 어떤 요청이 들어왔을 때 스킬을 로드해야 하는지, 실제 요청에 가까운 표현으로 설명합니다. 잘못된 예(라벨): "코드 리뷰를 도와줍니다." 목록을 읽는 사람에게는 스킬을 설명하지만, 특정 요청과 비교할 수 있는 정보가 거의 없습니다. "내 PR을 리뷰해 줘", "이 diff를 확인해 줘", "이 변경 사항을 살펴봐 줘" 같은 요청이 모두 연결되지 않을 수 있습니다. 좋은 예(트리거): "사용자가 pull request 리뷰, 버그를 찾기 위한 diff 확인, 병합 전 코드 재검토를 요청할 때 사용합니다. '이 PR을 리뷰해 줘', '내 변경 사항을 확인해 줘', '이 코드를 병합해도 될까' 같은 요청에서 트리거됩니다." 이렇게 작성하면 단순한 범주가 아니라 Claude가 비교할 수 있는 구체적인 문구와 상황을 제공할 수 있습니다.