세 도구 중 '가끔 필요한 절차'를 담는 자리. 상태 관리 라이브러리 지정처럼 항상 알아야 하는 '사실'은 CLAUDE.md에 남기되, 테스트 후 실패 분석이나 배포 순서 같은 '절차적인 작업'은 전부 스킬로 이사시킨다.
① 절차를 덜어내 CLAUDE.md를 다이어트
스킬 파일이 몇백 줄에 달하더라도, 메인 컨텍스트에는 이름(Name) · 설명(Description) · 인자(Args) 등 10줄 이내의 메타 정보만 올라간다. 상세 절차는 호출될 때만 로드되므로 비용과 컨텍스트가 절약된다.
---
name: test-fix
description: 테스트 실패 로그가 보이거나 "테스트 고쳐줘"라고 할 때 호출.
실패 원인을 분석하고, 수정 후 재실행까지 직접 수행한다.
args: [테스트_경로]
---
(상세 절차 200여 줄 — 호출될 때만 로드된다)
② 디스크립션이 자동 호출을 결정한다
스킬은 /스킬이름으로 수동 호출할 수도 있지만, AI가 적절한 타이밍에 자동으로 부르게 하려면 프론트매터의 디스크립션이 매우 중요하다.
디스크립션 작성 요령단순히 "테스트 수정"이라고만 적으면 발동하지 않는다. 어떤 키워드가 있을 때 호출해야 하는지, 혹은 직접 나서서 수정해야 한다는 행동 단서를 상세히 나열해야 스킬이 정상적으로 호출된다.
클로드코드 시작하기심화 · 스킬