유명 엔지니어들의 `.claude/skills` 공개 러시… 좋은 Claude Code Skills 작성법은?

AI 요약

유명 엔지니어들이 자신의 .claude/skills 디렉토리를 GitHub에 공개하면서, Claude Code Skills의 효과적인 작성법에 대한 관심이 급증하고 있다. Matt Pocock의 mattpocock/skills는 16만 스타, Addy Osmani의 addyosmani/agent-skills는 7.7만 스타를 기록하며, 실제 프로덕션에서 사용되는 SKILL.md 파일이 공개되었다. 좋은 Skill의 공통점은 description에 ‘무엇을, 언제 쓸지’를 명확히 기재하고, SKILL.md는 500행 이내로 유지하며 상세 내용은 별도 파일로 분리(progressive disclosure)하는 것이다. 또한 호출 방식은 결정론적으로 설계해, 사용자 호출(user-invoked)과 모델 호출(model-invoked)을 명확히 구분해야 한다.

핵심 포인트

• Matt Pocock의 mattpocock/skills 16만 스타, Addy Osmani의 addyosmani/agent-skills 7.7만 스타 기록
• description은 ‘무엇을 하는가’와 ‘언제 사용하는가’를 함께 기재, 선두에 키워드 배치
• SKILL.md는 500행 이내, 상세 내용은 별도 파일로 분리(progressive disclosure)
• 호출 방식: user-invoked(슬래시 명령)와 model-invoked(자동) 구분 설계

향후 전망

• Skills 수가 증가할수록 description의 정확성과 토큰 예산 관리가 더욱 중요해질 것