검색어를 입력하세요...⌘K

Skills (커스텀 슬래시 명령)

자주 쓰는 작업을 나만의 단축 명령으로 만들어 보세요.

Skills란?

Skills는 자주 하는 작업을 단축 명령으로 만들어 두는 기능이에요. 한 번 만들어 놓으면 /명령어 한 줄로 바로 실행할 수 있어요.

빠른 실행

/커밋처럼 한 줄이면 바로 실행돼요.

재사용 가능

한 번 만들면 어디서든 계속 쓸 수 있어요.

팀 공유

프로젝트에 넣어두면 팀원 모두 같은 명령을 쓸 수 있어요.

쉬운 형식

코딩 없이 텍스트 파일 하나로 만들 수 있어요.

저장 위치

Skills 파일은 두 곳에 저장할 수 있어요. 용도에 따라 골라 쓰세요.

구분개인용프로젝트용
경로~/.claude/skills/.claude/skills/
범위내 컴퓨터 전체해당 프로젝트만
Git 포함아니오예
팀 공유불가가능
추천 용도개인 습관, 메모 스타일팀 워크플로우, 코딩 컨벤션
팁: 폴더로 나눠서 정리할 수도 있어요. 예를 들어 .claude/skills/git/commit.md처럼 넣으면/git:commit으로 쓸 수 있어요.

만드는 법

1단계: 폴더 만들기

Skills를 저장할 폴더를 만들어요.

mkdir -p .claude/skills

내 컴퓨터 전체에서 쓰려면 mkdir -p ~/.claude/skills를 쓰세요.

2단계: SKILL.md 파일 작성

폴더 안에 텍스트 파일을 만들어요. 파일 이름이 곧 명령어 이름이 돼요.

.claude/skills/commit.md
---
name: commit
description: 변경사항을 커밋합니다
allowed-tools:
  - Bash(git diff:*)
  - Bash(git add:*)
  - Bash(git commit:*)
---

# 커밋 메시지 작성

1. `git diff --staged`로 변경사항을 확인하세요
2. 변경 내용을 요약하여 한국어 커밋 메시지를 작성하세요
3. 형식: "카테고리: 변경 내용 요약"
   - feat: 새 기능
   - fix: 버그 수정
   - docs: 문서 수정
   - refactor: 리팩토링

--- 사이의 부분은 설정(이름, 설명 등)이고, 아래는 Claude에게 보내는 지시 내용이에요.

3단계: 사용하기

Claude Code에서 /를 입력하면 내가 만든 명령이 목록에 나타나요.

/commit

뒤에 추가 정보를 붙일 수도 있어요: /commit 로그인 버그 수정

설정 항목 (--- 안에 적는 것들)

필드필수설명
name필수명령어 이름 (예: commit)
description필수명령어 설명 (목록에 표시됨)
allowed-tools선택이 명령에서 자동으로 허용할 동작 (매번 확인 안 물어봄)
context선택자동으로 읽어올 파일 목록
보안: allowed-tools에 Bash(git *)처럼 쓰면 git 관련 명령은 모두 허용돼요. 꼭 필요한 것만 허용하는 게 안전해요.

실전 예시

예시 1: 커밋 메시지 자동 생성

.claude/skills/commit.md
---
name: commit
description: 변경사항을 분석하여 커밋합니다
allowed-tools:
  - Bash(git diff:*)
  - Bash(git add:*)
  - Bash(git commit:*)
---

스테이징된 변경사항을 분석하고 커밋 메시지를 작성하세요.

## 규칙
- 한국어로 작성
- 형식: "카테고리: 요약" (feat/fix/docs/refactor/test)
- 50자 이내
- $ARGUMENTS가 있으면 커밋 메시지에 반영

사용: /commit 또는 /commit 로그인 기능 추가

예시 2: PR 리뷰 체크리스트

.claude/skills/review-pr.md
---
name: review-pr
description: PR의 변경사항을 리뷰합니다
allowed-tools:
  - Bash(git diff:*)
  - Bash(git log:*)
---

현재 브랜치의 변경사항을 리뷰하고 체크리스트를 작성하세요.

## 체크 항목
- [ ] 코드 스타일 일관성
- [ ] 에러 처리 누락 여부
- [ ] 불필요한 console.log 제거
- [ ] 타입 안전성 확인
- [ ] 테스트 커버리지

예시 3: 이슈 기반 브랜치 생성

.claude/skills/start-issue.md
---
name: start-issue
description: 이슈 번호로 작업 브랜치를 만듭니다
allowed-tools:
  - Bash(git checkout:*)
  - Bash(git branch:*)
---

이슈 번호를 받아 작업 브랜치를 생성하세요.

## 규칙
- 브랜치명: feature/$ARGUMENTS (예: feature/42)
- main 브랜치에서 분기
- 분기 후 해당 브랜치로 전환

사용: /start-issue 42

유용한 문법

문법설명예시
$ARGUMENTS명령어 뒤에 입력한 텍스트 전체/commit 버그 수정 → 버그 수정
$0, $1, $2...공백으로 구분된 개별 인자/deploy prod v2 → $1=prod, $2=v2
!`명령어`셸 명령어 결과를 본문에 삽입!`git branch --show-current`
인자 활용 예시
---
name: translate
description: 파일을 번역합니다
---

!`cat $1` 파일의 내용을 $2로 번역하세요.
번역된 내용을 같은 파일에 저장하세요.

사용: /translate README.md 영어