빌드 2 — 스킬 (Skills)

한 줄 요약 — 스킬은 “필요할 때만 펴보는 업무 매뉴얼” 입니다. Copilot Studio 스킬은 SKILL.md(YAML + Markdown)·ZIP이라는 오픈 스킬 포맷을 쓰며, 이는 Anthropic이 공개한 Agent Skills 개념과 사실상 같은 구조입니다.

참고 — 아래 스킬 개념은 Anthropic 공식 문서를 근거로 설명합니다. Microsoft 문서는 동일한 포맷(name·description·Markdown·ZIP)을 제공하지만 “Anthropic 기반”이라고 명시하진 않습니다 — 포맷·원리가 같아 함께 설명하되, 세부 동작은 각 제품 기준으로 확인하세요.

1. 스킬이란 — 신입 온보딩 가이드 비유

Anthropic: “에이전트에 스킬을 만드는 것은 신입 직원 온보딩 가이드를 만드는 것과 같다.”

스킬은 지침·스크립트·리소스를 담은 폴더로, 에이전트가 필요할 때 스스로 찾아 로드합니다. 범용 에이전트를 특정 업무 전문가로 바꿔주는 “절차 지식(어떻게 하는지)”의 묶음입니다.

보충 (MS Learn) — 스킬은 이름(name)·설명(description)·마크다운 지침으로 정의되는 기능 단위이며, 사용자 요청이 스킬의 목적과 일치하면 오케스트레이션 런타임이 스킬을 발동(invoke) 합니다. 재사용성·모듈성·공유성·명료성이 스킬을 쓰는 4가지 이유입니다.

2. 점진적 공개(Progressive Disclosure) — 3단계

스킬의 핵심은 한 번에 다 읽지 않는 것입니다. Anthropic은 이를 “목차 → 챕터 → 부록” 으로 비유합니다.

왜 중요한가 — 스킬이 100개라도 평소 컨텍스트에는 이름·설명만 있습니다. 그래서 스킬을 많이 두어도 컨텍스트가 가볍게 유지됩니다(= 컨텍스트 엔지니어링의 “적시 로드”).

3. SKILL.md 구조

---
name: rfp-toxic-clause-check
description: 발주 예정 RFP 초안에서 독소조항을 체크리스트 기준으로 찾을 때 사용. 일반 문서 요약에는 쓰지 말 것.
---

# 독소조항 점검 스킬
[RFP 초안]을 [독소조항 체크리스트 10항목] 기준으로 분석한다.
- 각 후보: 원문 인용 → 체크리스트 번호 → 위험도(상/중/하) → 근거 1문장
- 실제 존재하는 문구만 인용(추측 금지), 해당 없으면 "해당 없음"
- 최종 판단은 사람이 한다는 전제로 근거 중심 정리

단일 파일 vs 패키지

처음 스킬은 단일 파일로 시작하세요 — UI에 바로 등록되니 피드백이 빠르고, 스킬의 본질(재사용 지침)을 가장 또렷이 체감할 수 있습니다.

예 — “분석 결과를 늘 같은 형식으로 요약”하는 단일 파일 스킬:

---
name: result-brief
description: 분석 결과를 매번 똑같은 짧은 형식으로 요약할 때.
  "요약·브리핑·정리" 요청 시.
---
# 결과 브리핑
## 무엇을 하나 — 항상 이 고정 형식으로 정리
  한 줄 요약 / 핵심 숫자 / 눈에 띄는 점 / 다음 액션
## 규칙
  숫자는 분석 결과만, 5줄 안팎으로 짧게, 증감은 +/-로

→ YAML 2줄(name·description) + “언제·무엇을·규칙”만으로 스킬이 됩니다.

name 필드 규칙 — 소문자·숫자·하이픈만, 하이픈으로 시작·끝 불가. brand_comms ❌(언더스코어) · Brand-Comms ❌(대문자) · brand-comms ✅ · 위반 시 “Name must use only lowercase letters, numbers, and hyphens…” 오류가 납니다.

리소스로 담는 것들 — Python 코드(데이터 처리 패턴) · HTML 템플릿(메일·보고서) · 디자인 가이드(색·서식 규칙의 단일 진실 원천).

⚠️ 같은 이름 재업로드 함정 (2026-06 확인) — 스킬을 삭제 후 같은 이름으로 다시 올려도 구버전이 인식되는 사례가 있습니다 → -v2 같은 새 이름을 쓰고 Preview로 확인하세요. 참고로 스킬 삭제는 영구적(복구 불가)이니, 필요할 수 있으면 먼저 Download로 받아 두세요.

⚠️ 본문만 자동 주입됩니다 — 패키지에서 코어에 자동으로 들어가는 것은 SKILL.md 본문뿐이고, 번들 리소스(디자인 문서·코드)는 저장만 되어 에이전트가 능동적으로 열어야 합니다. 핵심 규칙은 반드시 본문에, 확장 자료만 리소스로 빼세요.

개념(Anthropic) — Anthropic은 스킬에 실행 스크립트를 넣어 결정적으로 처리하는 것을 권장합니다 — “Claude가 스크립트도 PDF도 컨텍스트에 올리지 않고 실행” (예: PDF 양식 필드 추출). ⚠️ 단, 번들 스크립트의 자동 실행은 Claude/코드 실행 환경의 기능입니다. Copilot Studio 스킬 패키지에서 스크립트가 동일하게 실행되는지는 프리뷰·라이선스·환경에 따라 다르므로 반드시 확인하세요(현재는 참고자료·템플릿 동봉이 핵심 용도).

4. 언제 스킬인가 — 지침 vs 스킬 vs 도구

5. 효과적으로 쓰는 법 — 3원칙

1. 단순하게 시작 — ① SKILL.md 한 장(규칙·형식) → ② +보조 문서(용어·맥락) → ③ +템플릿·리소스(고정 품질). 필요해질 때만 확장.
2. 모델이 혼자 못 하는 것을 담아라 — 검색으로 알 수 없는 운영 지식(예: “대용량 파일은 Base64가 아니라 OneDrive 링크로 첨부” — 토큰 폭발 방지).
3. 단일 진실 원천(Single Source of Truth) — 디자인 규격·절차는 스킬 한 곳에만. 지침·다른 스킬에 중복 금지.

6. 작성 원칙 (Anthropic)

• 평가로 시작 — 대표 과제를 돌려 부족한 부분(gap) 을 찾고 그 지점에 스킬을 만든다.
• 이름·설명이 트리거 — 구체적으로. 예: “X 용도로 사용하십시오. Y 용도로는 사용하지 마십시오.”
• 확장 시 분리 — 서로 배타적이거나 드물게 쓰는 내용은 별도 파일로.
• Claude 관점으로 관찰·반복 — 실제 사용 로그를 보고 성공 패턴을 스킬로 축적.
• ⚠️ 보안 — 신뢰할 수 있는 출처의 스킬만. 외부 네트워크 접속 지시·코드는 반드시 감사.

🧪 이 세션의 실습 → 실습 ② — 스킬: RFP 검토 보고서(관통) + VOC·패키지 업로드(기본)

M2 빌드로 → 다음: 도구·참고자료

출처: 2부 · 스킬 (Agentic Blog) · Equipping agents for the real world with Agent Skills (Anthropic) · Agent Skills overview (Claude Platform Docs) · Skills overview for agents (MS Learn) · Create a skill for an agent (MS Learn)