Claude는 각 SKILL.md의 description을 읽고 대화 맥락과 매칭을 시도한다. 이론상으로는 맥락이 맞으면 적절한 스킬이 로드되는 건데, 실제로는 자주 빗나간다.

description은 소프트 매칭이다. Claude에게 힌트를 주는 거지, 규칙을 부여하는 게 아니다. 특정 타이밍에 스킬을 정확히 실행시키려면 두 가지 방법이 있다.

방법 1: 직접 slash command. /skill-name 입력하면 바로 실행된다.

방법 2: CLAUDE.md에 trigger 규칙 명시. 아래처럼 적어두면 된다:

"commit"이라고 하면 smart-commit 스킬을 실행해.
구현이 완료되면 code-review 스킬을 실행해.

부작용이 있는 스킬 — 배포, 커밋, 메시지 발송 — 은 원래 이런 식으로 제어해야 하는 거다. disable-model-invocation: true 플래그도 같은 이유로 있는 거고. 의도치 않은 자동 실행을 막기 위해서다.

스킬이 원하는 타이밍에 안 켜진다면 description 문제가 아니라 trigger 방식 문제인 거다.