📚 FDE · 세션 · 에이전틱 개발 · L03

Skills

작성일자 2026-06-28 · 수정일자 2026-08-05 · 강의차수 L03 · 예상소요 15분

목표 이 강의가 끝나면 학습자가 스킬이 무엇인지 정의하고, Claude 가 스스로 골라 쓰는 원리를 이해하며, SKILL.md 한 장을 만들되 예외까지 정해야 한다는 것을 알고, 팀·다른 도구와 어떻게 공유되는지 설명할 수 있다.

1. 스킬이란?

스킬은 반복되는 작업 절차를 재사용할 수 있도록 지침화하여 파일 하나(SKILL.md)에 담은 것입니다. 각 스킬엔 "언제 쓰는지"가 적혀 있어, Claude 가 상황에 맞는 스킬을 스스로 찾아 그 지침대로 실행합니다.

스킬이란, 반복되는 작업 절차를 재사용할 수 있도록 지침화한 파일(SKILL.md).

2. 스킬 만들기

스킬은 .claude/skills/ 아래 스킬 이름과 같은 폴더에 둡니다. 폴더 이름이 곧 스킬 이름이고, 그 안의 파일 이름은 반드시 SKILL.md(대문자)입니다.

예를 들어 아침 정리를 대신하는 "아침 브리핑" 스킬은 .claude/skills/morning/SKILL.md 에 만듭니다. SKILL.md 외에, 지침이 함께 실행하는 스크립트(.sh·.py)를 같이 둘 수도 있습니다.

.claude/skills/
└── morning/          ← 폴더 이름 = 스킬 이름
    ├── SKILL.md      ← 파일 이름은 반드시 이것(대문자)
    └── fetch.sh      ← (선택) 함께 실행하는 스크립트 (또는 fetch.py)

---
name: morning
description: 아침 업무 브리핑을 만듭니다. 사용자가 "아침 브리핑", "오늘 시작",
  "출근 정리"를 언급하거나 하루를 시작할 때 이 스킬을 사용하세요.
---

# 아침 브리핑

아침에 필요한 정보를 한 페이지로 모아 줍니다.

## 작업 절차

1. 구글 캘린더에서 오늘 일정을 시간순으로 정리. 일정이 없으면 "오늘 일정 없음".
2. Gmail 안 읽은 메일을 보낸 사람·제목으로 요약. 20통 초과면 답장 필요한 것만.
3. 할 일 목록에서 오늘·이번 주 항목 추출. 마감 지난 항목은 맨 위.
4. 위 세 가지를 한 페이지로 합쳐 출력.

**반드시**:
- 개인 메일·사적 일정은 제외.
- 확인 안 된 일정은 지어내지 않기.
- 되돌릴 수 없는 동작 전에는 "진행할까요? (y/N)" 확인받기.

SKILL.md 는 특별한 코드가 아니라 사람이 읽는 메모입니다. 4개 영역으로 구분하여 작성합니다.

frontmatter: name·description 은 필수, 나머지는 선택.
# 제목: 스킬 이름과 한 줄 소개.
## 작업 절차: Claude 가 따라 할 단계.
**반드시**: 꼭 지켜야 할 규칙.

항목	필수	무엇
`name`	필수	스킬 이름(폴더명과 같게).
`description`	필수	언제 쓰는 스킬인지. Claude 가 이 줄을 보고 고릅니다.
`argument-hint`	선택	사용자가 함께 넘길 입력의 힌트.
`allowed-tools`	선택	스킬이 쓸 수 있는 도구를 제한합니다.
`user-invocable`	선택	`false` 면 `/` 메뉴에서 숨깁니다(기본은 보임).
`disable-model-invocation`	선택	`true` 면 Claude 의 자동 실행을 막습니다(배포·삭제처럼 위험한 스킬의 안전장치).

지침은 구체적으로, 예외 상황과 규칙까지 상세하게 적어야 일관된 결과를 얻습니다.

구체성: "일정을 불러온다"가 아니라 "구글 캘린더에서 오늘 일정을 시간순으로".
예외: "일정이 없으면", "메일 20통 초과면"처럼 안 될 때의 대처.
규칙: "사적 일정 제외"처럼 꼭 지켜야 할 선.
안전: 되돌릴 수 없는 동작은 **반드시** 규칙 작성.

간단해 보이는 스킬이라도 제대로 지침화하려면 생각보다 손이 많이 갑니다.

Q. 파일 이름을 morning.md 처럼 스킬 이름으로 바꿔도 되나요?

A. 안 됩니다. 파일은 언제나 SKILL.md(대문자)여야 합니다.

3. 스킬 사용 방법

직접 /morning 을 입력하여 스킬을 호출하거나, 자연어로 "아침 브리핑 해줘"처럼 입력하면 Claude 가 각 스킬의 description 을 보고 알맞은 스킬을 골라 실행합니다. 그래서 description 을 또렷하게 적을수록 말로 불렀을 때 더 정확히 골라집니다.

주로 이럴 때 만듭니다.

매번 같은 순서로 반복하는 일(정해진 절차가 있는 작업).
단계가 많아 하나씩 빠뜨리기 쉬운 일.
팀이 모두 똑같은 방식으로 해야 하는 일.

4. 팀·도구 공유

공들여 만든 스킬의 진짜 가치는, 그 수고를 혼자 쓰고 끝내지 않는다는 데 있습니다.

git 저장소에 올려 두면 팀원 모두가 같은 스킬을 내려받고, 누군가 스킬을 수정하면 수정된 스킬을 팀 전체가 공유합니다. 스킬은 클로드 전용 규격이 아니라 공개 표준이라, 같은 파일을 Codex 같은 다른 AI 도구도 그대로 읽어 들입니다.

한 번 잘 정리해 둔 작업 방식이 사람과 도구의 경계를 넘어 재사용되는 셈입니다.

5. 스킬 목록 (standarda-template, 2026-08-06)

스킬	자연어	설명
`/dev`	"개발 서버 켜줘"	Django 개발 서버 시작
`/develop`	"이 기능 스펙대로 개발해줘"	스펙 기반 구조화 개발
`/release`	"릴리즈 준비해줘"	릴리즈(배포) 자동화
`/feature-doc`	"기능 문서 정리해줘"	완성한 기능 문서 생성
`/client-guide`	"고객 테스트 가이드 만들어줘"	고객용 테스트 가이드 생성

스킬의 심화 내용은 엔지니어 세션 Skills에서 다룹니다.

마무리

핵심 정리: 스킬은 반복 작업의 방법을 SKILL.md 한 장에 정형화해 재사용하는 것입니다. 이름표의 "언제 쓰는지"를 보고 Claude 가 알아서 꺼내 씁니다. 구조는 단순하지만 잘 만들려면 예외까지 정해야 하고, 한 번 만들면 팀과 다른 도구가 함께 씁니다.
주의 사항: "잘 되는 경우"만 적은 스킬은 실제 상황에서 자주 어긋납니다. 그리고 "언제 쓰는지(description)"가 흐릿하면 Claude 가 못 꺼냅니다. 둘 다 또렷하게 적습니다.
다음 시간: 에이전트. 스킬이 무거운 일을 넘기는 그 "도우미"가 무엇인지.

이 강의를 학습하셨나요?