반복 작업을 스킬로 만들기
자주 하는 작업 순서를 스킬로 적어 두면, 매번 설명하지 않아도 /이름 한 번이나 상황에 맞춰 Claude가 같은 절차대로 처리합니다.
.claude/skills/<이름>/SKILL.md에 설명과 절차를 적고 /이름으로 불러 봅니다. 인자는 $ARGUMENTS로 받고, 저절로 불리면 곤란한 작업은 disable-model-invocation으로 직접 부를 때만 돌게 합니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다.
준비
- Claude Code 설치와 로그인
1. 스킬 폴더 만들기
프로젝트에서 팀과 나눌 스킬은 .claude/skills/<이름>/에, 나만 쓸 스킬은 ~/.claude/skills/<이름>/에 둡니다. 폴더 이름이 곧 명령 이름입니다.
mkdir -p .claude/skills/release-notes결과: 빈 스킬 폴더
확인: 폴더가 생겼는지 확인
2. SKILL.md 쓰기
맨 위 YAML에 description을 적습니다. Claude는 이 설명을 보고 언제 스킬을 쓸지 정하므로 "무엇을, 언제"를 분명히 씁니다. 본문에는 절차를 순서대로 적습니다.
---
description: 지난 태그 이후 커밋으로 릴리스 노트를 만든다. 릴리스 노트, 변경 기록 요청에 쓴다.
argument-hint: [버전]
---
1. git log로 마지막 태그 이후 커밋을 모은다.
2. 기능·수정·기타로 나눠 $ARGUMENTS 버전의 릴리스 노트를 쓴다.
3. CHANGELOG.md 맨 위에 붙인다.결과: .claude/skills/release-notes/SKILL.md
확인: 파일이 ---로 시작하는지 확인
3. 불러 보기
/이름 뒤에 인자를 붙여 부릅니다. 새 스킬이 목록에 없으면 /reload-skills를 실행합니다.
/release-notes 1.4.0결과: 스킬 절차대로 만든 릴리스 노트
확인: CHANGELOG.md 맨 위에 1.4.0 항목이 생겼는지 확인
4. 저절로 불리지 않게 하기
배포처럼 부르는 때를 사람이 정해야 하는 스킬은 frontmatter에 disable-model-invocation: true를 넣습니다. 목록에서 숨기려면 user-invocable: false를 씁니다.
disable-model-invocation: true결과: 직접 부를 때만 도는 스킬
확인: 관련 요청을 해도 스킬이 저절로 불리지 않는지 확인
5. 예전 명령 옮기기
.claude/commands/의 명령 파일은 그대로 동작하지만, 보조 파일을 함께 두려면 스킬 폴더로 옮깁니다. .claude/commands/deploy.md를 .claude/skills/deploy/SKILL.md로 옮기면 /deploy가 그대로 유지됩니다.
mkdir -p .claude/skills/deploy && git mv .claude/commands/deploy.md .claude/skills/deploy/SKILL.md결과: 스킬로 옮긴 명령
확인: /deploy가 계속 동작하는지 확인
주의
- description이 모호하면 엉뚱한 때 불리거나 안 불림. 쓰는 상황을 구체적으로
- 스킬이 실행하는 명령도 권한 규칙을 따름. allowed-tools로 필요한 도구만 열기
- 출처를 모르는 스킬은 안의 파일과 명령을 읽고 넣기
댓글