Claude Code

12장. Skills와 Hooks

반복 절차와 자동 반응은 나눠야 합니다

분기마다 외부 공유용 보고서를 검토합니다. 매번 개인정보, 내부 전용 표현, 확인되지 않은 숫자, 출처 없는 주장, 과장된 문장을 찾아야 합니다. 지시문은 길고, 한 번 빠뜨리면 외부로 나간 뒤에 문제가 됩니다.

이때 선택지는 세 가지입니다. 프로젝트의 기본 기준은 CLAUDE.md에 둡니다. 필요할 때 꺼내 쓰는 검토 절차는 Skill로 만듭니다. 특정 순간에 자동으로 실행해야 하는 반응은 Hook으로 다룹니다. 셋은 비슷해 보이지만 같은 도구가 아닙니다.

이번 장에서는 세 도구를 다음 기준으로 나눕니다.

  • 반복 절차와 자동 반응을 구분한다.
  • Skill이 필요한 순간을 안다.
  • Hook이 필요한 순간을 안다.
  • CLAUDE.md, Skills, Hooks를 나눠 쓴다.
  • 안전한 첫 Skill을 만든다.
  • Hook은 초반에 과하게 쓰지 않는다.

사람이 부르는 절차와 자동으로 도는 규칙은 다릅니다

반복 절차는 사람이 필요할 때 불러서 쓰는 작업 방식입니다. 예를 들어 "외부 공유 전 검토해줘"라고 요청하면 문서를 읽고 정해진 기준으로 점검하는 일입니다. 이런 일은 Skill에 어울립니다.

자동 반응은 특정 순간에 조건이 맞으면 실행되는 일입니다. 예를 들어 파일 수정 뒤 검사 명령을 실행하거나, 위험한 도구 사용 전에 차단하는 방식입니다. 이런 일은 Hook에 가깝습니다.

둘을 헷갈리면 자동화가 너무 빨리 커집니다.

질문Skill에 가까운가Hook에 가까운가
내가 필요할 때 직접 부를 일인가예아니오
특정 절차와 체크리스트가 중요한가예경우에 따라
매번 자동으로 실행되어야 하나아니오예
잘못 실행되면 작업을 막거나 바꿀 수 있나낮음높음

처음에는 Skill부터 생각하는 편이 안전합니다. Skill은 사람이 호출하거나 Claude Code가 관련 있다고 판단할 때 쓰는 절차입니다. Hook은 자동 실행이므로 영향 범위를 더 엄격하게 봐야 합니다.

Skill이 필요한 순간

Skill은 같은 지시, 체크리스트, 여러 단계 절차를 계속 붙여넣고 있을 때 좋습니다. 공식 문서에서도 반복해서 붙여넣는 지시나 절차, CLAUDE.md가 절차처럼 길어진 경우 Skill을 만들 수 있다고 설명합니다.

Skill이 어울리는 상황은 이런 경우입니다.

  • 월간 리포트 작성 절차를 매달 반복한다.
  • 외부 공유 전 검토 기준이 길다.
  • 회의록에서 결정사항, 담당자, 마감일, 확인 필요를 항상 같은 방식으로 뽑는다.
  • 참고 템플릿이나 예시 파일을 함께 써야 한다.
  • CLAUDE.md에 적기에는 너무 절차적이고 길다.

예를 들어 외부 공유 전 검토 Skill을 만들고 싶다면 바로 파일을 만들지 말고 설계부터 요청합니다.