본문으로 건너뛰기

반복 작업을 스킬로 만들기

자주 하는 작업 순서를 스킬로 적어 두면, 매번 설명하지 않아도 /이름 한 번이나 상황에 맞춰 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로 필요한 도구만 열기
  • 출처를 모르는 스킬은 안의 파일과 명령을 읽고 넣기

업무 분야 · 필요한 기능

이 기능을 가진 도구