스킬(SKILL.md) 처음 만들기 — 반복하는 지시를 AI에게 한 번에 가르치기
매번 붙여넣던 작업 순서를 SKILL.md 파일 하나로 정리하면, Claude Code가 필요할 때 알아서 꺼내 씁니다. 폴더 위치부터 첫 테스트까지 따라 해 보세요.
AI에게 일을 시키다 보면 같은 설명을 여러 번 하게 됩니다. "보고서는 이 순서로 써 줘", "안내문은 존댓말로, 마지막에 연락처를 넣어 줘" 같은 말들이죠. 스킬 은 이런 반복 지시를 파일로 정리해 두는 방법입니다. 한 번 만들어 두면 Claude Code가 상황에 맞을 때 스스로 불러오고, 직접 /스킬이름 으로 부를 수도 있습니다.
1. 스킬은 어디에 두나요?
스킬은 SKILL.md 라는 파일 하나가 들어 있는 폴더입니다. 폴더를 어디에 두느냐에 따라 쓰이는 범위가 달라집니다.
나만 쓰는 스킬 : ~/.claude/skills/스킬이름/SKILL.md — 내 컴퓨터의 모든 프로젝트에서 사용
프로젝트 스킬 : 프로젝트 폴더 안 .claude/skills/스킬이름/SKILL.md — 그 프로젝트에서만 사용, 함께 일하는 사람과 공유 가능
2. SKILL.md는 두 부분으로 되어 있습니다
머리말 : 맨 위 --- 사이에 적는 정보입니다. 특히 description (설명)이 중요합니다. Claude는 이 설명을 보고 "지금 이 스킬을 써야 하나"를 판단합니다.
본문 : 스킬이 실행될 때 Claude가 따를 실제 작업 순서입니다.
예를 들어 회의 메모를 정리하는 스킬은 이렇게 만들 수 있습니다.
mkdir -p ~/.claude/skills/meeting-notes
---
description: 회의 메모를 정리한다. 사용자가 회의록 정리, 회의 요약, 할 일 뽑기를 요청할 때 사용한다.
---
## 순서
1. 메모에서 결정된 것, 할 일, 미정인 것을 나눈다.
2. 할 일은 "누가 / 무엇을 / 언제까지" 표로 만든다.
3. 맨 위에 세 줄 요약을 쓴다.
4. 메모에 없는 내용은 지어내지 말고 "확인 필요"로 적는다.
3. 테스트해 보기
터미널에서 claude 를 실행한 뒤 두 가지로 확인합니다.
자동 호출 : "이 회의 메모 정리해 줘"처럼 설명(description)과 맞는 요청을 하면 Claude가 스킬을 불러옵니다.
직접 호출 : /meeting-notes 를 입력합니다. 폴더 이름이 곧 명령 이름이 됩니다.
4. 잘 만드는 요령
설명은 구체적으로 : "문서 작업"보다 "회의록 정리, 회의 요약, 할 일 뽑기를 요청할 때"처럼 실제로 쓸 말을 넣으면 자동 호출이 정확해집니다.
순서는 번호로 : 사람에게 업무 인수인계하듯 단계를 나눠 쓰면 결과가 일정해집니다.
하지 말 것도 적기 : "모르는 내용은 지어내지 않는다" 같은 금지 사항이 품질을 지켜 줍니다.
길어도 괜찮습니다 : 공식 문서에 따르면 스킬 본문은 실제로 쓰일 때만 불러오므로, 자세한 참고 자료를 넣어도 평소 부담이 거의 없습니다.
같은 지시를 세 번 이상 붙여넣었다면, 그게 바로 스킬로 만들 때라는 신호입니다.