Claude Code는 디스크에서 실제로 Skills를 설치하는 유일한 Claude 인터페이스이므로, 이에 대한 조언은 Custom Instructions에 관해 작성된 모든 내용과 다릅니다. 이 실용적인 가이드에서는 폴더의 작동 방식, 어떤 Skill을 남겨둘 가치가 있는지, 사람들이 어디에 시간을 낭비하는지 알아봅니다.
이 페이지
Claude Code에서 Skills가 작동하는 방식
Skills는 .claude/skills/ 디렉터리에 저장됩니다. 각 Skill은 그 안에 SKILL.md가 있는 하위 폴더입니다. 중요한 위치는 두 곳입니다.
-
프로젝트 - 저장소 내부의
.claude/skills/입니다. Skill이 코드와 함께 이동하므로 팀의 모든 구성원이 사용할 수 있습니다. 프로젝트에만 해당하는 내용은 여기에 둡니다. - 개인 - 홈 디렉터리의 동일한 경로입니다. 작업하는 모든 항목에 적용됩니다. 자신의 습관은 여기에 둡니다.
한 번에 하나만 저장하는 Custom Instructions와 달리, Claude Code에는 여러 Skills를 저장하고 현재 작업에 맞는 것을 가져오게 할 수 있습니다. 따라서 좋은 Skill의 형태도 달라집니다. 적절한 Skill이 선택될 만큼 설명이 정확해야 하고, 모든 작업에 선택되지 않을 만큼 범위가 좁아야 합니다.
Skill이 실제로 자리를 차지할 가치가 있으려면
이런 파일을 많이 만들어 보면서 일관된 패턴을 발견했습니다. 좋은 Skills는 정보가 아니라 결정을 담습니다.
REST API가 무엇인지 나열하는 Skill은 모델이 이미 알고 있는 내용에 토큰을 낭비합니다. 반면 "이 저장소의 모든 엔드포인트는 RFC 7807 형식으로 오류를 반환하며, 그렇지 않은 세 곳은 레거시이므로 복사해서는 안 된다"고 말하는 Skill은 영원히 보관할 가치가 있습니다. 모델이 추론할 수 없는 결정이기 때문입니다.
기준은 이렇습니다. 팀에 합류한 유능한 엔지니어에게 말해 줘야 하는 내용이라면 Skill에 넣으세요. 이미 알고 있을 내용이라면 빼세요.
갖춰 둘 가치가 있는 카테고리
팀 표준에 따른 코드 리뷰
일반적인 리뷰 의견은 잡음에 불과합니다. 팀의 실제 관례, 즉 팀에서 논의하고 합의한 내용을 담은 리뷰 Skill은 리뷰를 개인의 의견이 아니라 체크리스트로 바꿉니다.
테스트 관례
어떤 프레임워크를 사용하는지, 테스트 이름은 어떻게 짓는지, 무엇을 모킹하고 무엇은 절대 모킹하지 않는지, 이 코드베이스에서 어느 정도의 커버리지를 충분하다고 보는지 등을 정합니다. 이것이 없으면 학습 데이터에서 가장 흔했던 스타일로 테스트가 작성됩니다.
디버깅 및 장애 대응
로그가 어디에 있는지, 어떤 대시보드가 어떤 질문에 답하는지, 에스컬레이션 전에 확인할 네 가지가 무엇인지 담습니다. 새벽 3시에 비용을 톡톡히 해내는 Skill입니다.
인프라 및 배포
배포 순서, 프로덕션에서 실행해도 안전한 작업과 그렇지 않은 작업, 점검 시간이 필요한 마이그레이션을 기록합니다. 위험한 부분을 문서화하는 것이 핵심입니다.
문서화 및 기술 문서 작성
문서가 저장되는 위치, 페이지가 따르는 구조, 팀의 스타일에서 튜토리얼과 레퍼런스가 어떻게 다른지 정합니다.
생략할 것
언어 튜토리얼. Claude에게 Python 구문을 설명하는 Skill은 이미 Python 구문을 알고 있는 대상에게 Python 구문을 설명하는 Skill입니다.
거대한 만능 Skills. 프런트엔드, 백엔드, 테스트, 배포를 하나의 Skill에서 다루면 계속 로드되지만 매번 대부분은 관련이 없습니다. 나누세요.
한 달 뒤에 낡을 내용. 버전 번호, 현재 스프린트 목표, 당번 담당자의 이름 같은 내용입니다. Skills는 오래 유지되는 결정을 위한 것입니다.
모호한 설명. 설명에 Skill이 언제 적용되는지 명확하게 드러나지 않으면, 선택되지 않거나 항상 선택됩니다. 둘 다 쓸모가 없습니다.
빈 페이지 대신 템플릿으로 시작하기
가장 어려운 부분은 아이디어가 아니라 형식입니다. 얼마나 구체적으로 작성할지, 무엇을 제외할지, 선택이 제대로 작동하도록 설명을 어떻게 작성할지가 문제입니다. 이미 검증된 자료에서 그대로 참고할 가치가 있는 부분이 바로 이것입니다.
저희는 개발자, DevOps 엔지니어, 아키텍트를 위한 역할 기반 Skill 파일을 일반 .md 형식으로 제공하며, Claude Code Skill로 사용하거나 Custom Instructions에 붙여 넣을 수 있습니다.
Claude Code Skills →
개발자 Skills →
DevOps Skills →
아키텍트 Skills →
Claude Code를 사용하지 않는데도 이 페이지에 방문하셨다면, 웹에서 사용하는 Claude에 해당하는 기능은 Custom Instructions입니다.
KissMySkills는 독립적인 마켓플레이스이며 Anthropic, OpenAI 또는 그 밖의 어떤 AI 기업과도 제휴, 공식 승인 또는 연관 관계가 없습니다. Claude Code는 Anthropic의 제품입니다.