Claude Skills란 무엇인가

Skills는 AI 에이전트에게 "이런 상황에서는 이렇게 하라"를 가르치는 패키지입니다.

왜 필요했나

범용 모델은 일반적인 지식을 잘 다룹니다. 하지만 다음은 모릅니다.

• 우리 회사의 리포트 양식
• 이 팀의 배포 절차와 승인 라인
• 이 도메인에서만 통하는 용어와 규칙

매번 설명하면 되지만, 그러면 매번 같은 설명을 반복해야 합니다. Skills는 이 설명을 파일로 만들어 필요할 때 자동으로 불러오게 합니다.

구조

.claude/skills/monthly-report/
  SKILL.md           ← 절차 본문 + 발동 조건
  templates/         ← 참조 파일 (양식, 예시)
  scripts/           ← 실행 스크립트

SKILL.md의 프론트매터가 핵심입니다.

---
name: monthly-report
description: 월간 매출 데이터를 사내 표준 PDF 리포트로 변환한다.
  "월간 리포트", "매출 정리", "월말 보고서" 요청 시 사용한다.
---

## 절차

1. data/sales/ 에서 해당 월 CSV를 읽는다
2. 지역별·제품별로 집계한다
3. templates/report.html 양식에 채운다
4. scripts/to-pdf.sh 로 변환한다
5. 전월 대비 증감률을 요약해 함께 보고한다

슬래시 명령어와 무엇이 다른가

"부를 때 쓰는 것"과 "알아서 쓰이는 것"의 차이입니다.

점진적 로딩

Skills가 영리한 점은 여기 있습니다. 평소에는 name과 description만 메모리에 있습니다. 상황이 맞으면 그때 본문 전체를 읽습니다.

즉 Skills를 50개 만들어 둬도 평소 비용은 거의 없습니다.

어떤 일이 Skill이 되어야 하나

좋은 후보

• 절차가 정해져 있고 반복되는 일
• 사람마다 다르게 하고 있어 편차가 생기는 일
• 신입에게 매번 설명해야 하는 일

나쁜 후보

• 한 번만 하는 일
• 매번 판단이 크게 달라지는 일
• 모델이 이미 잘하는 일반적인 작업

정리

Skills는 암묵지를 파일로 만드는 작업입니다. 팀에 한 명만 알고 있던 절차를 문서화하면, 사람도 AI도 같이 쓸 수 있습니다.

다음 레슨

Skills가 해결하는 과제