2부 나를 가르친다
9장 · Custom Skill
Skill은 반복 업무의 인수인계서입니다. 내가 휴가 가도 신입이 그대로 따라 할 수 있게 적은 문서, 그 이름이 SKILL.md입니다.
지침만으로는 아쉬운 순간
지침은 그 방 안에서만 통합니다. 다른 방이나 새 방에선 다시 설명해야 합니다. 그리고 지침은 '항상' 적용됩니다. 긴 작업 순서를 넣으면 다른 일에도 끼어듭니다. "주간보고 써줘"마다 양식·순서·검토 기준을 또 말하고 있다면, 그 순서와 양식을 담는 파일이 따로 필요합니다. 그것이 Skill입니다.
| 구분 | 프롬프트 (1부) | 프로젝트 지침 | Skill |
|---|---|---|---|
| 형태 | 매번 입력하는 지시 | 방에 저장된 규칙 | 파일로 포장한 작업 레시피 |
| 적용 범위 | 그 대화 한 번 | 그 방의 모든 대화 | 필요할 때 어느 대화에서나 |
| 언제 켜지나 | 붙여넣을 때 | 항상 | 요청이 설명과 맞을 때 자동 |
| 잘 맞는 것 | 1회성 요청 | 말투·금지·배경 | 순서·양식이 정해진 반복 업무 |
Skill = 반복 업무의 인수인계서
내가 휴가 가도 신입이 그대로 따라 할 수 있게 적은 문서. 그 문서의 이름이 SKILL.md입니다. Skill은 폴더 1개이고, 그 안의 핵심 파일이 SKILL.md입니다. 맨 위에 이름(name)과 설명(description)이 있고, 본문에 입력 받기 → 작업 순서 → 출력 양식 → 주의사항이 들어갑니다. 필요하면 양식·예시 파일을 같은 폴더에 넣습니다. 처음엔 SKILL.md 한 장이면 충분합니다. 코드 없이 글로만.
---
name: meeting-summary
description: 회의 메모를 할 일·결정·요약으로 정리. "회의 정리해줘" 요청 시 사용
---
# 회의록 정리
## 순서
1. 회의명·날짜·참석자 확인 (없으면 물어보기)
2. 할 일 뽑기: 담당 / 할 일 / 마감 표
3. 결정 사항과 미해결 사항 나누기
## 출력: 제목 · 할 일 표 · 결정 · 요약 · 미해결
## 주의: 회의에서 나온 말만 — 모호하면 "결정 안 됨"
이름과 설명 규칙
| 칸 | 규칙 | 예 |
|---|---|---|
| name | 영문 소문자·숫자·하이픈(-)만, 64자 이내 | weekly-report |
| name 주의 | 'claude', 'anthropic' 단어는 쓸 수 없음 | my-report (O) |
| description | 무엇을 하는지 + 언제 쓰는지, 200자 이내 권장 | 주간보고 초안 작성. '주간보고 써줘' 요청 시 |
| 폴더 이름 | name과 똑같이 | weekly-report/ |
| 핵심 파일 | SKILL.md — 없으면 올리기 오류 | weekly-report/SKILL.md |
설명이 방아쇠입니다. Claude는 설명을 보고 이 Skill을 꺼낼지 정합니다.
만들기 4단계
| 단계 | 내가 할 일 | Claude가 할 일 |
|---|---|---|
| ① 말하기 | 내 업무 순서를 평소 말투로 설명 | 빠진 정보를 질문 |
| ② 초안 | 양식·잘 된 예시 결과물 제공 | SKILL.md 초안 작성 |
| ③ 테스트 | 실제 재료로 돌려 보고 3질문 점검 | Skill대로 결과물 생성 |
| ④ 반복 | 고칠 점을 말하고 "Skill에 저장해줘" | SKILL.md 수정 |
보통 2~3바퀴 돌면 쓸 만해집니다. 한 번에 완성하려 하지 마세요.
업무 하나 고르기
1부 반복업무 목록에서 '매주 같은 순서로 하는 일'이 1순위입니다. 기준은 한 달에 2번 이상 + 순서나 양식이 거의 같은 일. 그 일을 할 때의 순서를 메모장에 5줄 이내로 적습니다. "먼저 ○○, 다음 ○○." 잘 된 결과물 예시 1개도 준비합니다. 없으면 Claude 결과 중 마음에 든 것으로. 고민은 3분까지. Skill은 나중에 얼마든지 더 만듭니다.
| 업무 | 넣을 재료(입력) | 받을 결과(출력) |
|---|---|---|
| 주간보고서 | 이번 주 한 일 메모 | 회사 양식 보고서 |
| 제안서 | 고객사 · 요구사항 | 목차 · 핵심 메시지 초안 |
| 마케팅 기획 / 블로그 | 상품 · 타깃 · 키워드 | 기획안 / 블로그 원고 |
| 상세페이지 | 상품 특징 · 가격 | 섹션별 문구 |
| 고객응대 | 문의 내용 | 규정 기준 답장 초안 |
초안 요청
Second Brain 프로젝트 안에서 새 대화를 열면 내 자료·말투가 반영됩니다.
내 반복 업무를 Skill로 만들고 싶어. SKILL.md를 같이 만들자. 업무: [예: 주간보고서 작성] 내가 하는 순서: 1. [예: 월~금 한 일 메모를 모은다] 2. [예: 회사 양식에 맞춰 항목별로 정리한다] 3. [예: 다음 주 계획과 이슈를 붙인다] 요청: - 빠진 정보가 있으면 먼저 질문 3개 이내로 물어봐 - name은 영문 소문자-하이픈, description은 200자 이내 - 마지막 단계에 "사람이 확인한 뒤 발송" 넣기
SKILL.md 초안을 파일로 받아 my-brain/1_규칙/skills/ 안에 name과 같은 폴더를 만들어 저장합니다. 다른 방법도 있습니다(2026-09 기준): 사용자 지정 → 스킬 → '+' → 'Claude와 함께 창작하기'. 어느 방법이든 SKILL.md 한 장이 목표입니다.
인수인계서로 읽어 봅니다
- 내가 내일 휴가라면, 신입이 이 문서만 보고 똑같이 할 수 있나?
- 순서가 실제로 내가 하는 순서와 같은가? 한 단계씩 소리 내어 읽기
- '적당히', '알아서' 같은 말이 있으면 기준(개수·분량)으로 바꿉니다
- 설명(description)에 '언제 쓰는지'가 들어 있나?
코드 검토가 아니라 업무 문서 검토입니다. 여러분이 전문가입니다.
테스트 — 결과물을 받고 세 가지만 묻습니다
| 질문 | 찾는 것 | 이렇게 고칩니다 |
|---|---|---|
| 빠진 것은? | 늘 넣는 항목이 없음 | "○○ 항목을 항상 넣어줘" |
| 다른 것은? | 순서·말투·양식이 내 방식과 다름 | "△△ 순서로, 표는 3열로" |
| 불필요한 것은? | 안 쓰는 인사말·장황한 설명 | "서론 빼고 본론부터" |
방금 만든 SKILL.md대로 아래 재료로 결과물을 만들어줘. [이번 주 실제 메모 붙여넣기 — 민감정보는 가리고] (결과물을 확인한 뒤) 점검 결과를 알려줄게. SKILL.md에 반영해서 전체를 다시 보여줘. - 빠진 것: [예: 이슈 항목이 없음] - 다른 것: [예: 표가 아니라 문장으로 나옴] - 불필요한 것: [예: 맺음말 인사] 바꾼 줄은 무엇이 달라졌는지 따로 표시해줘.
세 바퀴가 넘으면 멈추고 다음으로 갑니다. 나머지는 쓰면서 다듬습니다.
'이번만 고치기' vs 'Skill에 저장해줘'
| 상황 | 말하는 법 | 결과 |
|---|---|---|
| 이번 건만 특별 (예: 이번 주만 휴무 안내) | "이번만 ○○ 넣어줘" | Skill은 그대로 |
| 앞으로도 매번 (예: 이슈 항목 항상 필요) | "이 규칙을 Skill에 저장해줘" | SKILL.md가 바뀜 |
매번 반복되는 수정만 저장합니다. 예외까지 넣으면 Skill이 뚱뚱해집니다.
claude.ai에 올리기
올리기 전 두 가지. 설정에서 '코드 실행 및 파일 생성'이 켜져 있어야 하고, 파일 모양은 ZIP 안에 폴더 1개, 그 안에 SKILL.md여야 합니다. weekly-report.zip → weekly-report/ → SKILL.md. ZIP을 열자마자 SKILL.md가 바로 보이면 틀린 모양입니다.
- 탐색기에서 내 Skill 폴더(예: weekly-report)를 우클릭 — 폴더 안이 아니라 폴더 자체
- 'ZIP 파일로 압축' (Windows 10은 보내기 → 압축(ZIP) 폴더, Mac은 우클릭 → 압축)
- claude.ai 왼쪽 메뉴 '사용자 지정' → '스킬' → 오른쪽 위 '+' → '스킬 업로드'
- ZIP을 끌어다 놓기 → '내 스킬' 목록에 뜨는지, 켜짐 스위치가 켜져 있는지 확인
새 대화에서 적용 확인
프로젝트 밖 새 대화를 엽니다. Skill은 방 밖에서도 쓸 수 있습니다. Skill 이름은 말하지 않고 평소처럼 "이번 주 주간보고 써줘" + 재료. Claude의 진행 과정에 내 Skill 이름이 보이면 성공입니다. 안 켜지면 "weekly-report Skill을 써서 해줘"처럼 이름을 불러 봅니다.
| 증상 | 원인 | 해결 |
|---|---|---|
| 올리기 오류 | ZIP 안에 폴더 없음 / SKILL.md 없음 | 폴더째 다시 압축 |
| 올렸는데 안 씀 | 설명에 '언제 쓰는지'가 없음 | description에 요청 문장 넣기 |
| 가끔만 씀 | 요청 표현이 설명과 다름 | 이름을 불러 요청하거나 설명 보강 |
| 스킬 메뉴가 없음 | 코드 실행 설정이 꺼짐 | 설정 → 기능에서 켜기 |
다시 쓸 수 있게 묶기
- Skill 원본은
my-brain/1_규칙/skills/에 — claude.ai와 따로 보관합니다 - 잘 된 예시 입력·결과물을 Skill 폴더에 함께 넣는 것이 공식 권장입니다
- 고칠 때: 원본 SKILL.md 수정 → 다시 ZIP → 다시 올리기
- 동료에게는 ZIP을 주면 됩니다. claude.ai의 Skill은 내 계정 전용이라 팀원은 각자 올립니다
남이 만든 Skill은 조심해서. Skill은 Claude에게 일하는 방법을 지시합니다. 프로그램 설치처럼 다루세요. 내가 만들었거나 믿을 수 있는 곳의 것만 올리고, 받은 Skill은 SKILL.md부터 읽어 이상한 지시가 없는지 봅니다. 내 Skill에도 비밀번호·고객 개인정보는 넣지 않습니다.
Second Brain + Skill
| 역할 | 담당 | 예 |
|---|---|---|
| 누구인가 · 무엇을 아는가 | 프로젝트(지침 + 자료) | 우리 말투 · 가격표 · 지난 회의록 |
| 어떻게 일하는가 | Skill | 주간보고 순서와 양식 |
| 둘을 합치면 | 프로젝트 안에서 Skill 요청 | "주간보고 써줘" → 내 자료로 내 양식 |
| 다른 업무로 넓히기 | 방은 그대로, Skill만 추가 | 고객응대 Skill, 블로그 Skill |
같은 부탁을 두 번 했다면 Skill 후보입니다. 한 개씩 늘립니다.
루틴 — 매일 5분, 매주 15분
| 언제 | 할 일 | 한 마디 예시 |
|---|---|---|
| 매일 5분 | 떠오른 메모는 4_수신함에 | "이거 수신함용 .md로 정리해줘" |
| 매일 5분 | 오늘 정한 것·회의는 3_기록에 | "오늘 결정을 3_기록용으로 정리해줘" |
| 매주 15분 | 수신함 비우기 → 서랍으로 이동 | "수신함 메모를 서랍별로 분류해줘" |
| 매주 15분 | 바뀐 자료 교체 · _INDEX 갱신 | "바뀐 파일 기준으로 _INDEX 고쳐줘" |
| 매주 15분 | Skill 한 줄 개선 | "이번 주 고친 점을 Skill에 저장해줘" |
핵심은 만들기가 아니라 매일 쓰기입니다. 안 쓰는 방은 빈 방입니다. 그리고 잊지 말 것 — Skill이 보고서·답장·상세페이지를 만들어도 발송·결제·삭제·공개는 내가 확인하고 누릅니다. Skill 마지막 단계에 '사람 확인'을 적어 두세요.
이 장의 결과물
- ☐ Skill로 만들 업무 1개를 골라 순서를 5줄 이내로 적었다
- ☐ SKILL.md 초안을 받았다 (name · description 포함)
- ☐ 실제 재료로 테스트하고 3질문으로 고쳐 다시 저장했다
- ☐ ZIP으로 묶어 claude.ai에 올리고 새 대화에서 켜지는 걸 봤다
- ☐ my-brain 폴더는 노트북에 그대로 — 3부에서 씁니다