# 반복 작업을 스킬로 만들기
id: claude-code-skills · 종류: 워크플로 · 상태: 검수 대기 (사람 확인 전) · 주제: 개발
주소: https://opencurrent.ai/w/claude-code-skills
기준일: 2026-11-21 (여기서 고친 날)
도구: Claude Code
걸리는 시간: 약 15분
평가 점수: 32/100 (확인 없음 · 검수 대기)

자주 하는 작업 순서를 스킬로 적어 두면, 매번 설명하지 않아도 /이름 한 번이나 상황에 맞춰 Claude가 같은 절차대로 처리합니다.

설명: .claude/skills/<이름>/SKILL.md에 설명과 절차를 적고 /이름으로 불러 봅니다. 인자는 $ARGUMENTS로 받고, 저절로 불리면 곤란한 작업은 disable-model-invocation으로 직접 부를 때만 돌게 합니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다.

준비물: Claude Code 설치와 로그인

단계:
1. [명령 실행 · Claude Code] 스킬 폴더 만들기 — 프로젝트에서 팀과 나눌 스킬은 .claude/skills/<이름>/에, 나만 쓸 스킬은 ~/.claude/skills/<이름>/에 둡니다. 폴더 이름이 곧 명령 이름입니다.
   프롬프트:
   > mkdir -p .claude/skills/release-notes
   기대 결과: 빈 스킬 폴더
   확인 방법: 폴더가 생겼는지 확인
2. [사람이 · Claude Code] SKILL.md 쓰기 — 맨 위 YAML에 description을 적습니다. Claude는 이 설명을 보고 언제 스킬을 쓸지 정하므로 "무엇을, 언제"를 분명히 씁니다. 본문에는 절차를 순서대로 적습니다.
   프롬프트:
   > ---
   > description: 지난 태그 이후 커밋으로 릴리스 노트를 만든다. 릴리스 노트, 변경 기록 요청에 쓴다.
   > argument-hint: [버전]
   > ---
   > 1. git log로 마지막 태그 이후 커밋을 모은다.
   > 2. 기능·수정·기타로 나눠 $ARGUMENTS 버전의 릴리스 노트를 쓴다.
   > 3. CHANGELOG.md 맨 위에 붙인다.
   기대 결과: .claude/skills/release-notes/SKILL.md
   확인 방법: 파일이 ---로 시작하는지 확인
3. [명령 실행 · Claude Code] 불러 보기 — /이름 뒤에 인자를 붙여 부릅니다. 새 스킬이 목록에 없으면 /reload-skills를 실행합니다.
   프롬프트:
   > /release-notes 1.4.0
   기대 결과: 스킬 절차대로 만든 릴리스 노트
   확인 방법: CHANGELOG.md 맨 위에 1.4.0 항목이 생겼는지 확인
4. [사람이 · Claude Code] 저절로 불리지 않게 하기 — 배포처럼 부르는 때를 사람이 정해야 하는 스킬은 frontmatter에 disable-model-invocation: true를 넣습니다. 목록에서 숨기려면 user-invocable: false를 씁니다.
   프롬프트:
   > disable-model-invocation: true
   기대 결과: 직접 부를 때만 도는 스킬
   확인 방법: 관련 요청을 해도 스킬이 저절로 불리지 않는지 확인
5. [명령 실행 · Claude Code] 예전 명령 옮기기 — .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로 필요한 도구만 열기
- 출처를 모르는 스킬은 안의 파일과 명령을 읽고 넣기

출처:
- Claude Code 문서: 스킬 https://code.claude.com/docs/en/skills
- Claude Code 문서: 내장 명령 https://code.claude.com/docs/en/commands