Claude Code 입문 ③ — 자주 하는 일을 '나만의 명령어'로 만드는 법Claude Code Basics ③ — Turn Repeated Work into Your Own Commands

좋은 지시문을 매번 다시 쓰고 있다면

Claude Code를 쓰다 보면 어느 순간 깨닫는다. 잘 작동했던 긴 지시문을 메모장에 복사해뒀다가 매번 다시 붙여넣고 있는 나 자신을.

이걸 해결하는 게 스킬(Skill) 이다. 검증된 작업 절차를 파일로 저장해두면, 다음부터는 /스킬이름 한 단어로 전체 절차가 실행된다.

프롬프트는 1회용이지만, 스킬은 자산이 된다.

스킬이 쌓이면 Claude Code는 범용 도구에서 내 업무에 특화된 전용 도구로 바뀐다. 이 글 하나로 첫 스킬을 만들고 운영하는 데 필요한 모든 것을 다룬다.

스킬의 구조: 파일 하나가 전부다

스킬은 작업 폴더의 .claude/skills/ 안에 폴더를 만들고, 그 안에 SKILL.md 파일 하나를 두는 것이다.

내 작업폴더/
└── .claude/
    └── skills/
        └── 요약노트/
            └── SKILL.md

이렇게 하면 /요약노트라는 명령어가 생긴다. SKILL.md의 기본 골격은 다음과 같다.

---
name: 요약노트
description: 문서 파일을 요약 노트로 변환한다
---

# 요약노트

## 실행 조건
사용자가 /요약노트 [파일경로] 로 호출할 때

## 절차
1. 파일을 처음부터 끝까지 읽는다 (일부만 읽지 않는다)
2. 핵심 주장 3가지와 근거 수치를 추출한다
3. '결과물/' 폴더에 [파일명]_요약.md 로 저장한다

## 금지사항
- 원문에 없는 내용 추가 금지
- 수치는 반드시 원문 그대로 인용

구성 요소는 네 가지다.

만드는 방법 2가지

방법 A: Claude에게 시키기 (추천)

가장 쉬운 방법은 방금 성공한 작업을 스킬로 굳히는 것이다. 어떤 작업을 만족스럽게 끝냈다면, 그 자리에서 이렇게 말한다.

“방금 한 작업 과정을 스킬로 만들어줘. 이름은 ‘요약노트’로.”

Claude가 대화 내용을 바탕으로 SKILL.md를 직접 작성한다. 절차가 실제 성공 사례에서 나오기 때문에 처음부터 손으로 쓰는 것보다 정확하다.

방법 B: 직접 작성하기

메모장으로 SKILL.md를 직접 써도 된다. 이 경우 요령이 하나 있다 — 처음부터 완벽하게 쓰려 하지 말 것. 절차 3줄로 시작해서, 쓰면서 발견되는 문제를 규칙으로 추가해 나가는 쪽이 훨씬 빠르다.

바로 쓸 수 있는 예시 스킬 3종

복사해서 이름과 경로만 바꾸면 되는 실전 예시다.

예시 1: 회의록 정리 스킬

---
name: 회의록
description: 녹취록·메모를 표준 회의록으로 정리
---

# 회의록

## 실행 조건
/회의록 [파일경로] 로 호출할 때

## 절차
1. 파일 전체를 읽는다
2. 다음 구조로 정리한다:
   - 회의 개요 (일시, 참석자, 주제)
   - 논의 내용 (주제별 3–5줄)
   - 결정 사항 (번호 목록)
   - 액션 아이템 (담당자, 기한 표기)
3. '결과물/회의록_[날짜].md' 로 저장한다

## 금지사항
- 발언하지 않은 내용을 추론해서 적지 않는다
- 결정 사항과 논의 사항을 섞지 않는다

예시 2: 파일 정리 스킬

---
name: 폴더정리
description: 다운로드 폴더를 규칙에 따라 분류
---

# 폴더정리

## 실행 조건
/폴더정리 로 호출할 때

## 절차
1. 다운로드 폴더의 파일 목록을 확인한다
2. 분류 규칙:
   - 이미지(jpg, png) → '사진/YYYY-MM/'
   - 문서(pdf, docx) → '문서/'
   - 설치 파일(exe, msi) → 목록만 보여주고 대기
3. 이동 계획을 먼저 보여주고, 승인 후 실행한다
4. 이동 결과를 표로 보고한다

## 금지사항
- 삭제는 어떤 경우에도 하지 않는다 (이동만)
- 계획 승인 없이 이동하지 않는다

예시 3: 주간 보고 스킬

---
name: 주간보고
description: 한 주의 작업 기록을 보고서 초안으로 변환
---

# 주간보고

## 실행 조건
/주간보고 로 호출할 때

## 절차
1. '기록/' 폴더에서 최근 7일 내 수정된 파일을 찾는다
2. 다음 구조의 초안을 작성한다:
   - 이번 주 완료 (3–7개, 성과 중심 서술)
   - 진행 중 (완료 예정일 포함)
   - 다음 주 계획
   - 이슈·건의 (없으면 생략)
3. '결과물/주간보고_[날짜].md' 로 저장한다

## 금지사항
- 기록에 없는 성과를 만들어내지 않는다
- 초안임을 문서 상단에 명시한다

어떤 작업을 스킬로 만들까

전부 스킬로 만들 필요는 없다. 판단 기준은 세 가지다.

세 가지 모두 해당하면 스킬로 만들 가치가 충분하다. 하나도 해당하지 않으면 그냥 말로 시키자.

운영 원칙: 실패하지 않는 스킬의 조건

1. 금지사항이 절차만큼 중요하다

“해라”는 잘 지켜지는데 “적당히 알아서”는 사고가 난다. 스킬을 운영하다 마음에 안 드는 결과가 나오면, 그 사례를 금지사항에 한 줄 추가한다. 좋은 스킬의 금지사항 목록은 곧 시행착오의 기록이다.

2. 되돌리기 어려운 단계 앞에는 확인을 넣는다

파일 삭제, 대량 이동, 외부 전송처럼 실수 비용이 큰 단계 앞에는 “계획을 보여주고 승인 후 실행한다”를 절차에 명시한다. 위 예시 2의 3번 단계가 그 예다.

3. 검토 단계를 절차 안에 넣는다

산출물의 품질 기준이 있다면, 그 기준을 체크리스트로 만들어 스킬이 스스로 검사하게 한다.

## 자체 검토
저장 전에 다음을 확인하고 결과를 출력한다:
- [ ] 모든 수치에 단위가 있는가
- [ ] 표에 구분선이 있는가
- [ ] 출처가 명시되었는가

이렇게 하면 품질 검사를 내 기억력에 의존하지 않게 된다.

4. 스킬도 버전 관리하듯 다듬는다

스킬은 만들고 끝이 아니라 계속 고치는 대상이다. 다듬는 방법도 간단하다 — “방금 결과에서 표 형식이 어긋났어. 스킬에 표 규칙을 추가해줘”라고 하면 Claude가 SKILL.md를 직접 수정한다.

흔한 실수 모음

• 너무 큰 스킬 하나 — “자료 조사부터 보고서 완성까지”를 한 스킬에 넣으면 중간에 통제를 잃는다. 조사 스킬과 작성 스킬로 나누는 게 낫다
• 절차가 모호함 — “적절히 정리한다”는 절차가 아니다. “표로 정리하고 3줄 요약을 붙인다”처럼 검증 가능하게 쓴다
• 사람의 검토를 생략 — 스킬이 아무리 정교해도 최종 확인은 사람 몫이다. 특히 외부에 나가는 산출물은 반드시 직접 읽어보자

시리즈를 마치며

설치(①) → 세팅(②) → 스킬(③)까지 왔다면 Claude Code 활용의 뼈대는 완성이다. 이제부터는 각자의 반복 작업을 하나씩 스킬로 바꿔가는 단계다. 첫 스킬은 오늘 가장 귀찮았던 작업으로 시작하는 것을 추천한다.