스킬

스킬은 커밋·리뷰·배포처럼 매번 같은 순서로 하는 일의 지시를 SKILL.md 파일 하나로 저장해 두고 /이름 한 줄로 실행하는 Claude Code의 재사용 워크플로우다. 항상 읽히는 CLAUDE.md와 달리 필요할 때만 불리며, 설명을 보고 Claude가 알아서 꺼내 쓰기도 한다.

폴더 하나, 파일 하나로 만든다

프로젝트의 .claude/skills/스킬이름/ 폴더에 SKILL.md를 만든다. 파일 맨 위에 이름과 설명을 적고, 그 아래에 할 일을 순서대로 쓰면 된다. 예전 커스텀 슬래시 명령도 지금은 이 방식에 합쳐져 있다.

같은 폴더에 스크립트나 템플릿 파일을 함께 두고 본문에서 가리킬 수도 있다. 이런 파일은 실제로 필요할 때만 읽히므로 컨텍스트를 아낄 수 있다.

설명이 자동 호출을 좌우한다

Claude는 평소에 스킬의 이름과 설명만 보고 있다가, 요청과 맞는 스킬이 있으면 본문을 불러온다. 그래서 설명에 "언제 쓰는지"를 분명히 적어야 제때 불린다. 배포처럼 함부로 실행되면 안 되는 스킬은 자동 호출을 끄고 직접 /deploy로만 부르게 해 두는 게 안전하다.

이런 일을 맡기면 좋다

예를 들어 /commit 스킬을 만들어 git diff를 보고 컨벤셔널 커밋 메시지를 써서 푸시까지 하게 할 수 있다. /review-pr는 PR 번호를 받아 보안·성능·스타일 관점으로 리뷰하게 만들 수 있다. 스킬 안에서 서브에이전트를 부르면 조사, 코드 작성, 검증을 나눠 동시에 돌릴 수도 있다.

한 번만 할 일이나 매번 방식이 달라지는 일은 그냥 대화로 시키는 편이 낫다. 세 번 넘게 같은 지시를 반복했다면 스킬로 만들 때다. 팀 스킬은 Git에 올라가니, 새 팀원도 /test, /deploy 같은 이름만 알면 팀의 방식을 그대로 따라갈 수 있다.