AI 요약
유명 엔지니어들이 자신의 Claude Code Skills 설정 파일을 GitHub에 공개하면서, 좋은 Skills 작성법에 대한 관심이 높아지고 있다. Matt Pocock(16만 스타)과 Addy Osmani(7.7만 스타)의 리포지토리를 분석한 결과, description 작성법, 점진적 정보 공개(progressive disclosure), 결정론적 호출 설계 등이 핵심 요소로 드러났다. Skills는 CLAUDE.md와 달리 필요할 때만 로드되므로, description이 호출 여부를 결정하며, SKILL.md는 500행 이내로 유지하고 상세 내용은 별도 파일로 분리하는 것이 권장된다.
핵심 포인트
- Matt Pocock의
mattpocock/skills는 16만 스타, Addy Osmani의addyosmani/agent-skills는 7.7만 스타 기록 - description은 3인칭으로 작성하고 '무엇을 하는지'와 '언제 사용하는지'를 명시해야 함
- SKILL.md는 500행 이내로 제한하고, 분기가 필요한 정보만 별도 파일로 분리(progressive disclosure)
- Skill 호출 방식은 user-invoked(슬래시 명령어)와 model-invoked(자동 호출)로 구분 설계
향후 전망
- Skills 생태계가 발전하면서 엔지니어 간 모범 사례 공유가 더욱 활성화될 전망
- Skills 수가 증가할수록 description의 정밀도가 더욱 중요해질 것
출처:hatena