CanRobot · 캔로봇
Microsoft Certified Trainer Microsoft MVP 2025

개요 3 — 스킬(Skills)

한 줄 요약 — 스킬은 필요할 때만 로드하는 재사용 지침 묶음입니다. Anthropic이 만든 오픈 Agent Skills 포맷을 기반으로 하며, 컨텍스트를 아끼는 핵심 장치입니다.

1. 스킬이란

스킬은 이름(name)·설명(description)·마크다운 지침(instructions) 으로 정의되는 기능 단위로, 선택적 리소스(예시·템플릿·스크립트)를 담아 에이전트가 항상 켜두지 않고 동적으로 로드합니다. “우리 조직이 이 일을 하는 단계별 방식”처럼 LLM이 스스로 알 수 없는 운영 지식을 제공합니다.

구성요소 역할
지침(Instructions) 항상 켜진 상위 규칙·성격
지식(Knowledge) 참조 데이터
도구(Tools) 커넥터·API·MCP로 실제 행동
스킬(Skills) 필요할 때만 로드하는 작업별 재사용 지침

2. 점진적 공개 (Progressive Disclosure)

점진적 공개 — 지침은 항상 로드, 스킬은 필요할 때만

오케스트레이터는 평소 스킬의 이름·설명(메타데이터)만 컨텍스트에 둡니다. 대화가 스킬 목적과 맞으면 그때 전체 지침을 로드합니다 — 스킬이 많아도 컨텍스트가 가볍게 유지됩니다.

3. SKILL.md 형식

스킬 패키지(.zip) 구조 — SKILL.md·scripts·references·assets

---
name: 인사 휴가 자격 심사
description: X 용도로 사용하십시오. Y 용도로는 사용하지 마십시오.
---

# Instructions
- 이 작업을 어떻게 접근하는지
- 단계별 로직
- 특정 도구 사용 패턴

💡 리소스 없는 단일 파일 스킬은 Build 탭 Skills → Create from blank로 이름·설명·지침을 직접 입력해 만들거나, .md 파일 자체를 Upload a skill로 업로드해 등록합니다 — zip 불필요. name소문자·숫자·하이픈만 허용, 선행/후행 하이픈 불가(brand-comms ✅ · brand_comms/Brand-Comms/-brand- ❌).

스킬 패키지(.zip)SKILL.md(YAML 프런트 매터 + 마크다운 지침) + 선택 리소스(스크립트·템플릿·참고 문서)를 묶어 배포·공유. 단, 코어에 자동 주입되는 것은 본문뿐 — 리소스는 에이전트가 필요할 때 여는 부록입니다. Copilot Studio에서 작성하거나, 텍스트 편집기로 만들어 업로드할 수 있고, GitHub Copilot·Claude Code 스킬을 임포트할 수도 있습니다. (업로드한 스킬은 UI에서 직접 편집할 수 없고, 다운로드 → 수정 → 교체(Replace) 로 갱신합니다.)

4. 오케스트레이터의 채택 타이밍

명시 호출이 아니라 이름·설명 기반으로 스킬 적용 여부를 판단합니다. Preview 탭의 활동 추적(activity trace) 에서 이 매칭 과정(Skill 노드)을 볼 수 있어, 너무 자주 뜨면(설명이 넓음) 좁히고, 안 뜨면(설명이 좁음) 넓혀 디버깅합니다.

5. 작성 원칙

  • 설명을 라우팅 메타데이터처럼 — 구체 이름(예: "인사 휴가 자격 심사") + 명시 범위(“X 용도로 사용하십시오. Y 용도로는 사용하지 마십시오.”).
  • 스킬은 참고 매뉴얼·플레이북·체크리스트·런북처럼 상황별 지식에 적합.
  • 항상 필요한 규칙은 스킬이 아니라 에이전트 지침에 둡니다.
  • 방법(How)은 스킬로 분리, 무엇(What)은 지침에 — 지침은 짧고 명확하게. 단순하게 시작해 Preview 테스트로 정제합니다.

M1 개요로 → 다음: 도구·MCP·연결된 에이전트

출처: Skills overview for agents (MS Learn) · Create a skill for an agent (MS Learn) · Add an existing skill to an agent (MS Learn) · 2부 · 스킬 (Agentic Blog) · Modern Agents Have Skills Now (MVP · The Custom Engine)