M2-5. 스킬 — 마크다운 기반 재사용 기능

한 줄 요약 — 스킬(skill) 은 이름·설명·마크다운 지침으로 정의하는 기능 단위로, “필요할 때만 펴 보는 업무 매뉴얼” 입니다. 사용자 요청이 스킬의 목적과 맞으면 런타임이 스킬을 불러 씁니다(invoke). Copilot Studio의 SKILL.md·ZIP은 Anthropic이 공개한 Agent Skills와 사실상 같은 오픈 스킬 포맷입니다.

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

1. 스킬을 쓰는 이유 — 신입 온보딩 가이드 비유

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

스킬은 지침·스크립트·리소스를 담은 폴더로, 범용 에이전트를 특정 업무 전문가로 바꿔 주는 “절차 지식(어떻게 하는지)” 묶음입니다. 공식 문서에서 꼽는 장점 4가지:

1. 재사용성(Reusability) — 한 번 만들어 여러 에이전트에 추가
2. 모듈성(Modularity) — 복잡한 동작을 역할이 분명한 조각으로 나눔
3. 공유성(Shareability) — 마크다운 파일·패키지로 내보내 공유
4. 명료성(Clarity) — 스킬마다 목적이 분명해 유지보수가 쉬움

다른 컴포넌트와의 비교

2. 동작 방식 — 점진적 공개(Progressive Disclosure) 3단계

런타임은 사용자 메시지와 스킬 설명을 보고 언제 스킬을 쓸지 정합니다. 핵심은 한 번에 다 읽지 않는다는 것입니다 — Anthropic은 이를 “목차 → 챕터 → 부록” 에 빗댑니다.

왜 중요할까 — 스킬이 100개라도 평소 컨텍스트에는 이름·설명만 있습니다. 지침은 늘 불러와 있지만(M2-1) 스킬은 필요할 때만 불러옵니다 — 그래서 세부 내용은 스킬로 빼야 컨텍스트가 가벼워집니다. 설명을 잘 써야 스킬이 제때 쓰입니다.

3. 스킬 파일·패키지 구조

첫 스킬은 단일 파일로 시작하세요 — UI에 바로 등록되어 결과를 빨리 확인할 수 있고, 스킬의 본질(재사용 지침)을 가장 분명하게 느낄 수 있습니다.

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

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

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

리소스로 담는 것 — Python 코드(데이터 처리 패턴) · HTML 템플릿(메일·보고서) · 디자인 가이드(색·서식 규칙을 한곳에서 관리).

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

개념(Anthropic) — Anthropic은 스킬에 실행 스크립트를 넣어 결정적으로 처리하기를 권장합니다. ⚠️ 단, 함께 넣은 스크립트를 자동 실행하는 것은 Claude/코드 실행 환경의 기능입니다 — Copilot Studio 스킬 패키지에서도 똑같이 실행되는지는 프리뷰·라이선스·환경에 따라 다르므로 꼭 확인하세요(지금은 참고 자료·템플릿을 함께 넣는 용도가 주력).

4. 처음부터 스킬 만들기 (Create from blank)

1. 에이전트 열기 → Build 탭 → 컴포넌트 패널에서 Skills 선택
2. Add skill에서 Create from blank 선택
3. 필드 정의:

1. Create 선택 → 컴포넌트 패널에 스킬이 나타남

name 규칙 위반 예시 — brand_comms ❌(언더스코어) · Brand-Comms ❌(대문자) · brand-comms ✅. 규칙을 어기면 “Name must use only lowercase letters, numbers, and hyphens…” 오류가 납니다.

지침 작성 모범 사례 — 작업·시나리오를 분명하게 설명, 단계별 응답 방법, 응답 서식 요구 사항, 예외 상황(edge cases)과 처리 방법, (필요하면) 참조할 도구. 단순하게 시작해 테스트하면서 다듬고, 추가한 뒤에는 Preview 탭에서 테스트하세요.

5. 기존 스킬 업로드

전제 — YAML 프런트 매터(이름·설명) + 지침이 담긴 마크다운 파일

1. Build 탭 → Skills → Add skill 섹션에서 Upload a skill 선택
2. 업로드 상자에 파일을 드래그 앤 드롭하거나 상자를 선택해 파일 찾아보기
3. 시스템이 파일을 검증(validate) 한 뒤 에이전트에 스킬을 추가

⚠️ 같은 이름으로 다시 올릴 때 주의 (2026-06 확인) — 스킬을 삭제한 뒤 같은 이름으로 다시 올려도 예전 버전으로 인식되는 사례가 있습니다 → -v2 같은 새 이름을 쓰고 Preview로 확인하세요.

6. 스킬 관리 — 편집·다운로드·교체·삭제

직접 편집은 처음부터 만든(from blank) 스킬만 할 수 있습니다. 업로드한 스킬은 다운로드 → 외부에서 편집 → 교체(Replace) 하는 방식으로 고칩니다.

• 편집(처음부터 만든 스킬) — 스킬 선택 → 스킬 구성 패널(skill configuration panel)에서 Name/Description/Instructions 수정 → Save → (권장) Preview 탭에서 확인
• 다운로드 — 처음부터 만든 스킬: 스킬 선택 → Download 아이콘 / 업로드한 스킬: 점 3개(…) → Download. YAML 프런트 매터 + 지침이 담긴 마크다운 파일로 받음(파일명 = 스킬 이름)
• 교체(업로드한 스킬) — 스킬 선택 → 점 3개(…) → Replace → 교체 파일 선택
• 삭제 — 컴포넌트 패널에서 스킬 옆 X 아이콘 → 확인 메시지에서 Delete. 영구 삭제되어 복구할 수 없습니다 — 나중에 필요할 수도 있다면 먼저 다운로드해 두세요.

요약 표

7. 언제 스킬을 쓸까 — 지침 vs 스킬 vs 도구

8. 잘 쓰는 방법 — 3원칙 + 작성 원칙

3원칙

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

작성 원칙 (Anthropic)

• 평가부터 시작 — 대표 과제를 실행해 부족한 부분(gap) 을 찾고, 거기에 맞춰 스킬을 만든다.
• 이름·설명이 곧 트리거 — 구체적으로 쓴다. 예: “X 용도로 사용하십시오. Y 용도로는 사용하지 마십시오.”
• 커지면 나누기 — 서로 겹치지 않거나 가끔 쓰는 내용은 별도 파일로 뺀다.
• 관찰하고 반복 — 실제 사용 기록을 보고 잘된 패턴을 스킬에 쌓아 간다.
• ⚠️ 보안 — 믿을 수 있는 출처의 스킬만 쓴다. 외부 네트워크에 접속하라는 지시나 코드는 반드시 검사한다.

핵심 정리

1. 스킬 = 이름 + 설명 + 마크다운 지침 — “필요할 때만 펴 보는 업무 매뉴얼”, 언제 쓸지는 설명으로 정해짐
2. 점진적 공개 3단계(메타데이터→본문→리소스) — 스킬이 많아도 컨텍스트는 가볍다
3. 단일 파일로 시작, 리소스가 필요해지면 패키지로 — 단 자동으로 들어가는 건 본문뿐이니 핵심 규칙은 본문에
4. Create from blank 또는 Upload a skill — 이름은 소문자·숫자·하이픈만, 다시 올릴 때는 새 이름 권장
5. 업로드한 스킬은 다운로드→외부 수정→Replace, 삭제하면 되돌릴 수 없음
6. 선택 기준: 항상 = 지침 / 상황별 절차·형식 = 스킬 / 실제 행동 = 도구

(기능·화면·명칭은 프리뷰 기준이며 바뀔 수 있음)

🧪 실습: ④ 검토 보고서 스킬 · 보고서 양식 스킬(Markdown→HTML→Word · M365 Copilot 활용)

M2 허브로 · 이전 ← M2-4. 도구 · 다음 → M2-6. 연결된 에이전트

출처: Skills overview (MS Learn) · Create a skill (MS Learn) · Add an existing skill (MS Learn) · Manage and delete skills (MS Learn) · Equipping agents for the real world with Agent Skills (Anthropic) · Agent Skills overview (Claude Platform Docs)