3부 · 단일 스킬 작성

4. 단일 스킬 작성

▶ 목표: UI에 바로 붙여넣는 SKILL.md 한 장짜리 스킬을 만들어 본다(2부 2.4). 가장 쉬운 형태로 스킬을 체감하여 워크플로우를 이해해본다.

4.1 단일 스킬이란

리소스 없이 SKILL.md 한 장으로 끝나는 스킬입니다. UI에서 바로 등록되어 피드백이 빠릅니다. ZIP·업로드 절차가 없습니다.

지침 vs 스킬 — 용도 구분: 지침(2장)은 항상 켜져 있는 상위 규칙(헌법)이고, 스킬은 필요할 때만 끌어다 쓰는 재사용 지침입니다. 특정 작업의 “방법·형식”(예: 결과를 항상 같은 형식으로 요약)은 지침에 박지 말고 스킬로 내려야 지침이 가볍고 재사용이 쉬워집니다.

4.2 만들기 — 주간 판매 브리핑 스킬

이 실습에서 쓰는 실제 단일 스킬은 데모의 weekly-sales-brief/SKILL.md 한 장입니다. excel-analysis가 계산한 결과를 늘 같은 형식의 짧은 “주간 브리핑”으로 정리합니다.

1. Build 화면에서 Skills → Add skill (단일/인라인) 선택.
2. 아래 SKILL.md 내용을 그대로 붙여넣습니다.

---
name: weekly-sales-brief
description: 판매 데이터 분석 결과를 매번 똑같은 짧은 형식의 "주간 브리핑"으로 정리할 때 사용. "주간 요약·브리핑·정리·한 장 요약" 요청 시.
---

# 주간 판매 브리핑

분석 결과를 **늘 같은 형식의 짧은 요약**으로 정리하는 스킬입니다.
(파일은 이 SKILL.md 한 장뿐입니다. 별도 자료·코드 필요 없음.)

## 언제 쓰나
"이번 주 요약", "브리핑으로 정리", "한 장으로 요약" 같은 요청.

## 무엇을 하나
분석 결과를 아래 **고정 형식**으로 정리합니다. 항상 이 순서·이 항목을 지킵니다.

```
📊 주간 판매 브리핑 — [기간]

한 줄 요약: [가장 중요한 결론 한 문장]

핵심 숫자
- 총매출: [값] (전주 대비 [+/-%])
- 1위 제조사: [이름] ([값])
- 베스트 모델: [이름] ([값])

눈에 띄는 점
- [관찰 1]
- [관찰 2]

다음 액션(제안)
- [할 일 1]
```

## 규칙
1. **숫자는 분석 결과만** 사용하고 지어내지 않습니다. 없으면 "데이터 없음"으로 둡니다.
2. 항목은 **5줄 안팎**으로 짧게. 길어지면 핵심만 남깁니다.
3. 증감은 **+/-**와 함께 표시합니다(예: +12%).
4. "다음 액션"은 데이터에서 자연스럽게 나오는 제안만 적습니다.

짚고 가기: 핵심은 “언제 쓰는지(트리거) + 무엇을(고정 형식) + 규칙” 세 가지뿐입니다. 리소스·코드 없이 이 한 장이면 단일 스킬이 됩니다.

4.3 스킬 작성 팁 (2부 2장 요약)

• YAML 2줄 필수 — name(소문자·숫자·하이픈만)과 description.
• description = 트리거 — “언제 쓰는지 + 키워드”를 또렷이. 오케스트레이터가 이 한 줄로 로드(사용) 여부를 판단한다.
• 단순하게 시작 — 규칙·형식만으로 충분하면 단일 파일로 끝낸다. 필요해지면 5장처럼 리소스를 더한다.

짚고 가기: name은 소문자·숫자·하이픈(-) 만 됩니다. 언더스코어(_)·대문자·공백은 업로드가 거부됩니다(5장 함정에서 다시).