Claude Code 스킬 작성 10계명

Claude Code 스킬 레지스트리를 오픈소스로 관리하시는 분이 159개 스킬을 작성하면서 정리한 원칙인데, 저도 스킬 만들면서 공감되는 부분이 많아서 가져와봤습니다.

핵심 원칙 중에 특히 와닿는 것들:

• Description은 요약이 아니라 트리거 조건으로 써야 한다 — 이거 진짜 중요합니다. 요약으로 쓰면 Claude가 언제 스킬을 불러야 할지 판단을 못해요.
• 스킬은 파일이 아니라 폴더 단위로 관리 — references/, scripts/, assets/ 구조로 나누면 유지보수가 훨씬 편합니다.
• 200줄짜리 설명보다 스크립트 하나 넣는 게 낫다 — 이건 실무에서 뼈저리게 느끼는 부분이에요.
• 스킬에 **메모리(SQLite, JSON)**를 주면 실행 간 맥락이 유지된다

레포: github.com/AbsolutelySkilled/AbsolutelySkilled 159개 전부 오픈소스이고 npx skills add로 설치 가능합니다.

스킬 만들고 계신 분들 참고하시면 좋을 것 같아요.