시리즈를 따라오신 분이라면 Claude Code에 매번 비슷한 요청을 하고 있다는 걸 느끼셨을 겁니다. "커밋 메시지 한국어로 써줘", "이 코드 리뷰해줘", "오늘 할 일 확인해줘" 같은 것들이요. 매번 이걸 다 타이핑하는 건 비효율적입니다. 커스텀 스킬을 만들면 /commit 한 단어로 같은 결과를 얻을 수 있습니다.
커스텀 스킬이 뭔가요?
커스텀 스킬은 내가 자주 하는 요청을 미리 적어두고, 슬래시 명령어 하나로 실행하는 기능입니다. Claude Code에 "이런 상황에선 이렇게 해" 하고 적어둔 메모장이라고 생각하면 됩니다.
| 일상 속 비유 | Claude Code 커스텀 스킬 |
|---|---|
| 단축 다이얼 — 1번 누르면 엄마한테 전화 | /commit 입력하면 자동으로 커밋 메시지 작성 |
| 커피머신 원터치 버튼 — 누르면 아메리카노 완성 | /morning 입력하면 아침 루틴 점검 시작 |
| 자동차 네비 즐겨찾기 — "집"만 누르면 경로 설정 | /review 입력하면 코드 리뷰 시작 |
그러니까 매번 길게 설명하던 요청을 한 단어로 줄이는 겁니다. 스킬 자체는 마크다운 파일 하나에 불과한데, 그 파일 하나가 매일 반복되는 타이핑 시간을 아껴줍니다.
스킬 만드는 법 — 3단계
스킬을 만드는 건 메모장에 지시사항을 적어서 정해진 폴더에 넣는 것과 같습니다. 프로그래밍 지식이 전혀 필요 없습니다.
1 폴더와 파일 만들기
스킬은 정해진 위치에 SKILL.md라는 파일로 저장합니다. 예를 들어 /commit 스킬을 만들고 싶다면 이렇게 합니다.
폴더 이름이 곧 명령어 이름이 됩니다. commit 폴더를 만들면 /commit으로 실행할 수 있습니다.
2 SKILL.md에 지시사항 작성
파일 안에 Claude에게 시킬 내용을 적습니다. 평소에 채팅창에 치던 말을 그대로 적으면 됩니다.
name: commit
description: 커밋 메시지 자동 생성
---
현재 git diff를 확인하고,
변경 내용을 요약한 커밋 메시지를 한국어로 작성한 뒤,
커밋을 생성해줘.
위쪽 --- 사이에 들어가는 부분은 스킬의 이름과 설명입니다(프론트매터). 아래쪽이 실제 지시사항입니다.
3 사용하기
Claude Code를 실행하고 슬래시를 치면 됩니다.
Claude가 SKILL.md에 적힌 지시사항을 읽고 그대로 실행합니다. 매번 "git diff 보고 한국어로 커밋 메시지 써줘"라고 타이핑할 필요가 없어집니다.
반드시
~/.claude/skills/스킬이름/SKILL.md 구조를 지켜야 합니다. 폴더 이름을 잘못 짓거나 파일 이름이 다르면 인식되지 않습니다. SKILL.md의 대소문자도 정확히 맞춰주세요.
실전 예시 3가지
이론만으로는 감이 안 잡히실 수 있습니다. 비개발자도 바로 쓸 수 있는 실전 스킬 세 가지를 소개합니다.
1. /commit — 커밋 메시지 자동 생성
파일 위치: ~/.claude/skills/commit/SKILL.md
name: commit
description: 커밋 메시지 자동 생성
---
현재 git diff를 확인하고, 변경 내용을 요약한
커밋 메시지를 한국어로 작성한 뒤 커밋을 생성해줘.
언제 쓰나: 코드를 수정한 뒤 저장할 때. 11편 Git에서 배운 커밋 과정을 한 단어로 줄여줍니다.
2. /review — 코드 변경사항 리뷰
파일 위치: ~/.claude/skills/review/SKILL.md
name: review
description: 코드 변경사항 리뷰
---
현재 git diff를 확인하고, 아래 관점에서 리뷰해줘:
1. 버그 가능성이 있는 부분
2. 개선할 수 있는 부분
3. 잘한 부분
결과를 한국어로 정리해줘.
언제 쓰나: 작업을 마치고 커밋하기 전에 한 번 점검하고 싶을 때. "내가 실수한 거 없나?" 확인하는 용도입니다.
3. /morning — 아침 루틴 점검
파일 위치: ~/.claude/skills/morning/SKILL.md
name: morning
description: 아침 루틴 점검
---
아래 순서대로 확인해줘:
1. 현재 프로젝트의 git status 확인
2. 어제 마지막 커밋 내용 요약
3. 오늘 해야 할 작업 제안
언제 쓰나: 아침에 컴퓨터 켜고 Claude Code를 열었을 때. "어제 어디까지 했더라?" 하면서 기억을 더듬는 시간을 줄여줍니다.
프로젝트 전용 스킬 vs 전체 스킬
스킬을 저장하는 위치에 따라 적용 범위가 달라집니다.
| 구분 | 저장 위치 | 적용 범위 | 비유 |
|---|---|---|---|
| 전체 스킬 | ~/.claude/skills/이름/SKILL.md |
내 컴퓨터의 모든 프로젝트에서 사용 | 스마트폰 기본 앱 — 어디서든 쓸 수 있음 |
| 프로젝트 전용 스킬 | .claude/skills/이름/SKILL.md |
해당 프로젝트 폴더에서만 사용 | 회사 전용 앱 — 그 회사 안에서만 작동 |
차이는 맨 앞의 ~(물결표)입니다. ~가 붙으면 내 홈 폴더에 저장되어 어디서든 쓸 수 있고, ~ 없이 프로젝트 폴더 안에 만들면 그 프로젝트에서만 작동합니다.
실전 팁: /commit이나 /review처럼 어디서든 쓰는 스킬은 전체 스킬로 만드세요. 특정 프로젝트에서만 필요한 스킬(예: "이 프로젝트의 배포 절차")은 프로젝트 전용으로 만들면 됩니다. 프로젝트 전용 스킬은 Git에 포함되기 때문에 팀원과 공유할 수도 있습니다.
예전에는
.claude/commands/이름.md 방식으로 커스텀 명령어를 만들었습니다. 이 방식은 여전히 지원되지만, 새로 만든다면 skills/이름/SKILL.md 구조를 쓰는 게 권장됩니다.
자주 묻는 질문 (FAQ)
Q. 스킬을 만들려면 프로그래밍을 알아야 하나요?
아닙니다. SKILL.md 파일 안에 평소 Claude에게 채팅으로 치던 말을 그대로 적으면 됩니다. 마크다운 형식이라 메모장 수준의 텍스트 편집만 할 줄 알면 충분합니다.
Q. 스킬 하나에 여러 작업을 넣어도 되나요?
됩니다. 위의 /morning 예시처럼 여러 단계를 순서대로 적으면 Claude가 차례로 실행합니다. 다만 너무 많은 작업을 한꺼번에 넣으면 결과가 부정확해질 수 있으니, 복잡한 작업은 나눠서 별도 스킬로 만드는 게 좋습니다.
Q. 스킬을 수정하면 바로 반영되나요?
네. SKILL.md 파일을 수정하고 저장하면, 다음에 해당 스킬을 실행할 때 바로 반영됩니다. Claude Code를 재시작할 필요도 없습니다.
Q. 다른 사람이 만든 스킬을 가져다 쓸 수 있나요?
프로젝트 전용 스킬은 Git 저장소에 포함되기 때문에, 저장소를 공유하면 팀원이 같은 스킬을 쓸 수 있습니다. 전체 스킬은 SKILL.md 파일을 복사해서 자기 ~/.claude/skills/ 폴더에 넣으면 됩니다.
Q. 기존 .claude/commands/ 방식은 이제 못 쓰나요?
아직 지원됩니다. 기존에 만들어둔 커맨드가 있다면 그대로 쓸 수 있습니다. 새로 만드는 경우에만 skills/이름/SKILL.md 구조가 권장됩니다.
정리하며
관점 한 스푼: 도구를 잘 쓰는 사람의 특징은 반복을 싫어한다는 겁니다. 같은 말을 두 번 이상 타이핑하고 있다면, 그건 스킬로 만들 수 있다는 신호입니다. 처음에는 "이걸 왜 파일로 따로 만들어야 하지?" 싶을 수 있습니다. 그런데 한 번 만들어두면 매일 쓰게 됩니다. 단축 다이얼을 한 번 등록하면 다시는 번호를 일일이 누르지 않는 것처럼요. 작은 자동화 하나가 매일의 작업 흐름을 바꿉니다. 거창한 기술이 아닙니다. 반복을 줄이는 습관입니다.
다음 편에서는 AI 여러 명한테 동시에 일 시키는 법을 다룹니다
18편 보러 가기 →
참고 자료
· Anthropic Claude Code 공식 문서 — docs.anthropic.com
댓글
댓글 쓰기