이 핸즈온랩은 교육 내용을 보여 드리기 위한 예시입니다. 실제 교육과정에서는 고객사의 산업과 직무를 반영한 실습 시나리오로 구성한 비공개 학습 사이트를 따로 제공합니다.
Lab 0-4 — 고급 스킬 · 스킬 패키지 업로드
▶ 목표:
SKILL.md+ 리소스(디자인 지침·HTML 템플릿) 를 묶은 ZIP을 업로드해 고성능 스킬을 만든다(M2-5).
1. 왜 패키지로 만드나
UI에서 만드는 단일 스킬은 파일 하나만 쓸 수 있습니다. 하지만 메일·보고서처럼 디자인·템플릿을 고정하려면
리소스를 함께 묶어야 합니다. SKILL.md + 지원 파일(스크립트·템플릿·참고 문서)을 담은 ZIP 패키지로 만들면 됩니다.
이 실습에서는 아래 ZIP 파일 2개를 업로드합니다(직접 만들어도 됨). 패키지별 역할은 다음과 같습니다.
| 패키지(ZIP) | 구성 | 역할 |
|---|---|---|
휴가·근태 분석 스킬 (leave-analysis.zip) |
SKILL.md + 데이터-설명(선택).md |
엑셀을 정확히 집계·표로 정리하는 규칙(다관점 연차 촉진 대상 분석) |
메일·보고서 스킬 (brand-comms.zip) |
SKILL.md + design-set.md + email_template.html + report_template.html |
회사 브랜드(블루 #0F6CBD·다크그레이 #424242)로 메일·HTML 대시보드 생성 |
📦 공개 과정용 실습 파일 패키지는 준비 중입니다. 본문에 있는 자료를 복사해 붙여 넣는 것만으로도 모든 실습을 진행할 수 있습니다. ZIP은 압축을 풀지 말고 그대로 업로드합니다(교육용 예시 자료입니다).
패키지 폴더 구조 / 업로드 버튼 위치
2. 업로드 절차
- Build 화면 Skills → Add skill → Upload a skill 선택.
- 업로드 박스에
leave-analysis.zip·brand-comms.zip을 각각 드래그 앤 드롭(스킬 2개). 업로드하면 시스템이 파일을 검증(validate)한 뒤 추가합니다. - 업로드 후 Instructions 미리보기에 SKILL.md 본문(예: 색상 HEX 표)이 보이는지 확인.
3. 스킬 패키지 작성 팁 (M2-5 요약)
- ZIP 루트에
SKILL.md— 폴더를 통째로 압축하면폴더명/SKILL.md가 되어 “Bundle is missing a root-level SKILL.md” 로 거부됩니다. 폴더 안 내용물을 압축하세요.- PowerShell:
Compress-Archive -Path "스킬폴더\*" -DestinationPath out.zip
- PowerShell:
- 이름 규칙 —
name은 소문자·숫자·하이픈만(선행/후행 하이픈 불가). 버전은-v2처럼 하이픈으로. - 핵심 규칙은 SKILL.md 본문에 —
design-set.md같은 리소스는 자동 주입되지 않습니다. 팔레트 HEX·”새로 디자인하지 말고 템플릿을 써라” 같은 필수 규칙은 SKILL.md 본문에 직접 적고, 세부 내용만 리소스로 나누세요. - 수정은 다운로드 → 교체(Replace) — 업로드한 스킬은 UI에서 직접 편집할 수 없습니다. 스킬의 점 3개(…) 메뉴에서 Download 후 외부 편집기로 고쳐 Replace로 갱신하세요.
- AI 도구로 다듬기 — “이 작업을 스킬로 만들어 줘 / 이 HTML을 템플릿으로 분리해 줘”처럼 Copilot에 맡기면 구조·트리거를 함께 정리해 줍니다.
4. ⚠️ 프리뷰 이슈 — 개인 개발환경에서는 스킬 패키지가 제대로 올라가지 않음 (2026-06-14 기준)
현재 프리뷰에서는 개인 개발환경에서 New(CLI) 에이전트가 정상 작동하지 않습니다. 그 증상 중 하나로, ZIP이 UI에는 정상으로 보이지만 실제로는 SKILL.md의 YAML(이름·설명)만 올라가고 본문·리소스가 누락됩니다.
- 증상: 에이전트가 스킬을 선택하기는 하지만 디자인·절차를 따르지 않음(“상세 가이드가 없다”며 마음대로 디자인).
- 원인: 개인 개발환경 자체의 프리뷰 제약. 게시 여부·스킬 언어와 무관하며, 같은 ZIP도 Sandbox 환경에선 정상 동작합니다(스킬·설계 문제 아님).
- 확인 방법 (UI 표시만 믿지 말 것): Preview 탭 채팅에 다음을 입력합니다.
네가 가진 app/skills 의 하위 폴더까지 모두 보여줘
- ✅ 정상: 스킬 폴더 아래
SKILL.md+ 리소스가 모두 보임. - ❌ 문제:
SKILL.md만 보이고, 그마저도 본문이 비어 있으며 내부 번들 포인터만 보임. - 해결: Sandbox 환경에서 에이전트를 만드세요. 개인 개발환경에서는 다시 업로드하거나 이름을 바꿔도 잘 해결되지 않습니다. Sandbox에서 업로드 후 위 프롬프트로 검증하고 시작하세요.
app/skills 확인 프롬프트 결과 — 정상 vs 문제
← 3. 단일 스킬 · 다음: 5. 커넥터·MCP 추가
출처: Add an existing skill to an agent — Microsoft Learn · Manage and delete skills in an agent — Microsoft Learn · 3부 · 스킬 패키지 임포트 — Microsoft Copilot Agentic Blog