MicrosoftDocs/Agent-Skills

🚀

Azure 개발을 위한 에이전틱 스킬 (Agentic Skills). Microsoft Azure를 위한 엄선된 프로덕션 준비 완료(production-ready) 스킬로 AI 코딩 어시스턴트의 성능을 극대화하세요. 다음 도구들과 원활하게 작동합니다:

🟣

Azure Agent Skills는 Azure 클라우드 개발을 위해 특별히 설계된 **고품질 에이전틱 스킬 (high-quality agentic skills)**의 엄선된 컬렉션입니다. 이 스킬들은 에이전트 스킬 (Agent Skills) 오픈 표준을 따르며, 현대적인 AI 코딩 어시스턴트와 원활하게 작동하여 Azure 서비스에 대한 전문가 수준의 가이드를 제공합니다.

🚀 처음이신가요? 여기서 시작하세요!
🔌 호환성 및 호출 (Compatibility & Invocation)
📦 기능 및 카테고리 (Features & Categories)
🎁 엄선된 컬렉션 (번들) (Curated Collections (Bundles))
📚 모든 스킬 찾아보기 (Browse All Skills)
🛠️ 설치 (Installation)
🧠 사용 방법 (How to Use)
📖 에이전트 스킬 (Agent Skills) 문서 (Agent Skills Documentation)
🤝 기여 방법 (How to Contribute)
⚖️ 라이선스 (License)

AI 에이전트 (GitHub Copilot, Claude Code 또는 Cursor와 같은)는 똑똑하지만, Azure 서비스에 대한 구체적이고 최신화된 지식이 부족합니다. **스킬 (Skills)**은 AI 에이전트가 매번 Azure 서비스를 올바르게 다루는 방법을 가르치는 마크다운 (markdown) 지침, 스크립트 및 리소스가 포함된 폴더입니다.

💡 스킬은 AI 에이전트에게 도메인 특화 전문 지식을 제공하는 재사용 가능한 파일 시스템 기반 리소스입니다. 이는 필요할 때 즉시 로드되며, 대화 전반에 걸쳐 동일한 가이드를 반복해서 제공할 필요를 없애줍니다.

Microsoft Learn 문서는 에이전트가 효과적으로 행동하는 데 정확히 필요한 **결정, 절차, 모범 사례 및 제약 조건 (decisions, procedures, best practices, and constraints)**을 이미 인코딩하고 있습니다. 매번 원문 텍스트를 검색하고 요약하기 위해 RAG (Retrieval-Augmented Generation)에 의존하는 대신, 우리는 이 지식을 구조화되고 실행 가능한 스킬로 사전 컴파일 (pre-compile) 합니다.

사전 구축된 스킬로서의 문서 (Documentation as Pre-Built Skills): 많은 효과적인 에이전트 스킬은 새로운 발명품이 아닙니다. 이는 이미 문서에 존재하는 구조화된 패턴, 워크플로 및 결정 로직입니다. Learn 콘텐츠가 무엇을 포함하고 있는지 생각해 보십시오:

API 패턴 및 사용 가이드 (API patterns and usage guidance)
서비스 구성 절차 (Service configuration procedures)
플랫폼 베스트 프랙티스 및 제약 사항 (Platform best practices and constraints)
문제 해결 결정 트리 (Troubleshooting decision trees)
보안 및 준수 요구 사항 (Security and compliance requirements)

우리의 접근 방식:

추출 (Extract): Learn 콘텐츠에서 가치가 높고 작업 지향적인 역량을 추출합니다.
분류 (Classify): 목적(제한 사항, 문제 해결, 구성, 아키텍처 등)에 따라 분류합니다.
공개 (Reveal): 사용자의 의도와 관련이 있을 때만 공개합니다.

이 지식은 에이전트가 직접 사용할 수 있도록 **액션(actions), 선택지(choices), 가드레일(guardrails)로 사전 컴파일(pre-compiled)**되어 있습니다. 즉, 해석이 필요한 가공되지 않은 텍스트(raw text)가 아닙니다.

각 스킬은 다음을 제공합니다:

📚 주제별로 정리된 큐레이션된 문서 링크
🔗 Microsoft Learn 콘텐츠로의 직접 액세스
🎯 베스트 프랙티스 및 아키텍처 패턴
⚠️ 문제 해결 가이드 및 일반적인 실수(common pitfalls)

빠른 시작을 위한 짧은 경로 — 전체 설치 세부 사항은 아래의 🛠️ Installation 섹션에 있습니다.

리포지토리(repo)를 클론(Clone)합니다:

git clone https://github.com/MicrosoftDocs/agent-skills.git

skills/ 폴더의 내용을 AI 어시스턴트의 스킬 경로로 복사합니다 (대상 테이블 및 중요 참고 사항은 🛠️ Installation을 참조하십시오).

VS Code 사용자: 에디터가 스킬을 로드할 수 있도록 설정(Settings)에서 chat.agent.skills를 활성화합니다.

코딩을 시작하십시오 — AI 어시스턴트가 설치된 스킬을 자동으로 발견하고 사용합니다.

스킬은 필요한 경우에만 콘텐츠를 효율적으로 로드하기 위해 점진적 공개 (progressive disclosure) 방식을 사용합니다:

레벨 1 - 발견 (Discovery): 에이전트가 YAML 프론트매터(frontmatter)에서 스킬의 name과 description을 읽습니다.
레벨 2 - 지침 (Instructions): 트리거되었을 때, 에이전트가 전체 SKILL.md 콘텐츠를 로드합니다.
레벨 3 - 리소스 (Resources): 에이전트가 필요에 따라 추가 파일(스크립트, 예제)에 액세스합니다.

설치가 완료되면, AI 어시스턴트에게 자연스럽게 질문하십시오:

"Durable Functions를 사용하여 Azure Functions를 설정하는 것을 도와줘"

"Azure Container Apps의 베스트 프랙티스는 뭐야?"

"Azure API Management를 어떻게 구성해?"

스킬이 공식 Microsoft 문서로부터 자동으로 컨텍스트(context)를 제공할 것입니다.

이 스킬들은 Agent Skills 오픈 표준(SKILL.md

형식)이며, 에이전트 스킬(agentic skills)을 지원하는 모든 AI 코딩 어시스턴트(AI coding assistant)와 함께 작동합니다.

AI 코딩 어시스턴트 (AI Coding Assistant)	유형 (Type)	스킬 경로 / 위치 (Skills Path / Location)	호출 방법 (How to Invoke)
Claude Code	Anthropic CLI	`.claude/skills/`	자연어, `/skill-name`
Gemini CLI	Google DeepMind	`.gemini/skills/`	자연어
Codex CLI	OpenAI	`.codex/skills/`	자연어
Antigravity IDE	DeepMind IDE	`.agent/skills/`	에이전트 모드, 자연어
GitHub Copilot	VSCode Ext	`.github/skills/`	자연어, `@workspace`
Cursor	AI-native IDE	`.cursor/skills/`	채팅창에서 `@skill-name`
OpenCode	Open-source CLI	`.agent/skills/`	`opencode run @skill-name`
AdaL CLI	SylphAI Agent	`.adal/skills/`	자동 로드, 자연어

💡

경로 참고(Path Note): ~는 사용자의 홈 디렉터리(home directory)를 나타냅니다:

macOS/Linux: ~ = /Users/yourname 또는 /home/yourname

Windows: ~ = %USERPROFILE% = C:\Users\yourname (PowerShell에서는 $HOME 사용)

💡

팁(Tip): 대부분의 최신 도구들은 .agent/skills/를 범용 경로로 지원합니다. GitHub Copilot의 경우, Agent Skills 사양에 따라 .github/skills/ 사용을 권장합니다.

이 저장소는 Azure 서비스 도메인별로 구성되어 있습니다:

카테고리	스킬	예시
☁️ 컴퓨팅 (Compute)	13	Azure App Service, Azure Batch, Azure Cloud Services, Azure Cyclecloud, Azure Functions
🔗 통합 (Integration)	16	Azure API Center, Azure API Management, Azure Business Process Tracking, Azure Communication Services, Azure Data API Builder
📊 데이터 및 분석 (Data & Analytics)	19	Azure Analysis Services, Azure Cache Redis, Azure Cosmos Db, Azure Data Explorer, Azure Data Factory
🤖 AI 및 ML (AI & ML)	23	Azure AI Services, Azure AI Vision, Azure Anomaly Detector, Azure Bot Service, Azure Cognitive Search, Azure Foundry Classic, Azure Foundry Local, Microsoft Foundry
🔒 보안 및 ID (Security & Identity)	19	Azure Active Directory B2C, Azure Attestation, Azure Cloud Hsm, Azure Confidential Computing, Azure Confidential Ledger
🌐 네트워킹 (Networking)	23	Azure Application Gateway, Azure Bastion, Azure DDoS Protection, Azure Dns, Azure Expressroute
🏗️ 인프라 (Infrastructure)	52	Azure Advisor, Azure AKS Edge Essentials, Azure API Management, Azure Arc, Azure Architecture, Azure Container Storage, Azure Elastic SAN
💰 관리 (Management)	39	Azure Advisor, Azure API Management, Azure Architecture, Azure Artifacts, Azure Automation
🎮 특화 (Specialized)	26	Azure AKS Edge Essentials, Azure API Management, Azure App Configuration, Azure App Service, Azure Communication Services

총합: 19개 카테고리에 걸쳐 193개의 스킬 ✓

어디서부터 시작해야 할지 모르겠나요? 빠르게 생산성을 높일 수 있도록 역할 기반의 스킬 번들을 만들었습니다.

번들 (Bundle)	설명
🚀 Quick Start	모든 Azure 개발자에게 필수적인 요소 — 먼저 이 7가지 핵심 서비스를 마스터하세요
⭐ Popular	인기 있는 Azure 서비스. 대부분의 워크로드 (Workloads)를 구동하는 서비스
🎯 Core	핵심 Azure 필수 요소. 전문화하기 전에 모든 개발자에게 필요한 기초
🤖 AI/ML Developer	AI 엔지니어 및 ML 실무자를 위한 번들. AI 서비스, 머신러닝 (Machine Learning), 그리고 지능형 애플리케이션을 다룹니다
📊 Data Engineer	데이터 엔지니어 및 분석 전문가를 위한 번들. 데이터 통합 (Data Integration), 웨어하우징 (Warehousing), 그리고 스트리밍 분석 (Streaming Analytics)을 다룹니다
🏗️ Infrastructure Pro	인프라 엔지니어 및 클라우드 아키텍트 (Cloud Architects)를 위한 번들. 네트워킹 (Networking), 백업 (Backup), 복구 (Recovery), 그리고 리소스 관리 (Resource Management)를 다룹니다
🔒 Security & Compliance	RBAC, 정책 (Policy), 키 관리 (Key Management), 그리고 컴플라이언스 (Compliance)를 통해 Azure 워크로드를 보호합니다
🌐 DevOps & Automation	배포 (Deployments), 모니터링 (Monitoring), 그리고 인프라 관리 (Infrastructure Management)를 자동화합니다
🔗 Integration	API Management, Event Grid, Logic Apps, 그리고 Service Bus를 통해 Azure 서비스를 연결합니다
☁️ Full-Stack Azure	아키텍처 기초를 포함한 완전한 범위를 다룹니다

💡

권장 경로 (Recommended Path):

Quick Start 번들로 시작하세요
더 넓은 범위를 다루려면 Popular 번들을 추가하세요
자신의 역할에 따라 전문화된 번들을 선택하세요

이 README를 깔끔하게 유지하기 위해 전체 스킬 레지스트리 (Skill Registry)를 전용 카탈로그로 이동했습니다.

스킬 (Skill)	설명
All Azure Skills	사용 가능한 모든 Azure 스킬의 전체 목록
Skill Descriptions	스킬 설명 및 기능 (Capabilities)
Skill Files	개별 스킬 파일로 연결되는 링크

디렉토리 (Directory)	용도
`skills/`	AI 에이전트 (AI Agents)가 사용할 수 있는 프로덕션 준비 완료 (Production-ready) 스킬
`products/`	스캔 결과, 원시 데이터 (Raw Data), 그리고 보고 아티팩트 (Reporting Artifacts)

products/ 폴더는 **스캔 파이프라인 출력물 (Scan Pipeline Outputs)**을 저장하며 다음 용도로 사용됩니다:

Raw Data (원시 데이터): 추출된 노드(nodes) 및 메타데이터(metadata)를 포함하여, 가장 최근의 문서 스캔(documentation scan) 결과
Classification Reports (분류 보고서): 각 노드가 왜 스킬(skill)로 분류되었는지(또는 제외되었는지)에 대한 상세 기록
Incremental Tracking (증분 추적): 델타 처리(delta processing) 및 변경 사항 탐지(change detection)를 지원하기 위한 과거 스캔 데이터

⚠️ 참고: products/ 디렉토리는 내부 파이프라인 사용 및 기여자(contributor) 참조용입니다. 최종 사용자(End users)는 skills/ 디렉토리만 필요합니다.

선호하는 AI 코딩 어시스턴트(AI coding assistant)에 따라 설치 경로를 선택하세요.

⚠️ 참고: 이 리포지토리(repository)는 skills/ 하위 디렉토리에 스킬들을 포함하고 있습니다. 먼저 리포지토리를 클론(clone)한 다음, 스킬들을 대상 위치로 복사하세요.

먼저, 이 리포지토리를 로컬 머신의 위치(예: 홈 폴더 또는 임시 디렉토리)로 클론하세요:

git clone https://github.com/MicrosoftDocs/agent-skills.git

사용 중인 AI 어시스턴트에 따라 skills/ 폴더 내부의 내용물을 대상 위치로 복사하세요:

AI 어시스턴트	프로젝트 수준 (내 리포지토리 내)	개인/글로벌 (모든 프로젝트)
GitHub Copilot	`{your-project}/.github/skills/`	`~/.copilot/skills/`
Claude Code	`{your-project}/.claude/skills/`	`~/.claude/skills/`
OpenAI Codex	`{your-project}/.codex/skills/`	`~/.codex/skills/`
Cursor	`{your-project}/.cursor/skills/`	—
Gemini CLI	`{your-project}/.gemini/skills/`	—
Antigravity IDE	`{your-project}/.agent/skills/`	`~/.gemini/antigravity/skills/`
OpenCode	`{your-project}/.agent/skills/`	`~/.agent/skills/`
AdaL CLI	`{your-project}/.adal/skills/`	`~/.adal/skills/`

⚠️ 중요: skills/ 폴더 자체를 복사하지 말고, skills/ 내부의 폴더들(예: azure-functions/, azure-container-apps/)을 복사하세요.

✅ 올바른 예:
.copilot/skills/azure-functions/SKILL.md

❌ 잘못된 예:
.copilot/skills/skills/azure-functions/SKILL.md

💡 경로 참고:
~ = 홈 디렉토리 (Home directory)
Windows: C:\Users\yourname (PowerShell에서는 $HOME 사용)
macOS/Linux: /Users/yourname 또는 /home/yourname

VS Code에서 Agent Skills 활성화하기 (VS Code 사용자 필수):

Agent Skills는 현재 **실험적 기능 (experimental feature)**입니다. 반드시 수동으로 활성화해야 합니다:

VS Code 설정 열기 (Windows/Linux에서는 Ctrl + ,, macOS에서는 Cmd + ,)
chat.agent.skills 검색
"Chat: Use Agent Skills" 체크박스 선택

⚠️ 중요: 이 설정이 활성화되지 않으면 VS Code는 어떤 스킬도 로드하거나 사용하지 않습니다!

복사한 후, 더 이상 필요하지 않다면 클론(cloned)한 agent-skills 리포지토리(repository)를 삭제해도 됩니다.

대부분의 스킬은 Microsoft Learn에서 최신 문서를 가져오기 위해 **네트워크 액세스 (network access)**가 필요합니다.

옵션 1: Microsoft Learn MCP 서버 (권장)

전체 문서를 가져오기 위해 mcp_microsoftdocs:microsoft_docs_fetch를 사용합니다.

옵션 2: Web Fetch 도구

문서 URL에서 콘텐츠를 검색하기 위해 fetch_webpage를 사용합니다.
Azure 서비스에 대해 질문하기: Azure Container Apps에서 블루-그린 배포(blue-green deployments)를 어떻게 구현하나요?
스킬이 제공하는 것:
- Microsoft 공식 문서로의 직접 링크
- Microsoft Learn의 모범 사례 (Best practices)
- 아키텍처 패턴 및 코드 예제
AI의 문서 검색 방식:
- AI 어시스턴트가 MCP 도구를 사용하여 최신 콘텐츠를 가져옵니다.
- 정확하고 최신화된 가이드를 받을 수 있습니다.

Agent Skills는 AI 에이전트에게 새로운 능력을 부여하기 위한 **개방형 표준 (open standard)**입니다. 각 플랫폼이 스킬을 어떻게 구현하는지 자세히 알아보세요:

플랫폼	문서	설명
Agent Skills Standard	agentskills.io	`SKILL.md` 형식을 위한 개방형 사양
GitHub Copilot	About Agent Skills	Copilot 코딩 에이전트, CLI 및 VS Code를 위한 스킬
VS Code Copilot	Agent Skills in VS Code	에이전트 모드(agent mode)를 사용한 VS Code에서의 스킬 활용
Claude Code	Agent Skills Overview	Claude Code 및 Claude API에서의 스킬
OpenAI Codex	Agent Skills	Codex CLI 및 IDE 확장을 위한 스킬

리포지토리	설명
anthropics/skills	공식 Anthropic 스킬 (DOCX, PDF, PPTX, XLSX)
...

모든 스킬에는 SKILL.md가 필요합니다.

YAML frontmatter가 포함된 파일:

---
name: your-skill-name # 소문자, 하이픈만 사용, 최대 64자
description: 기능 설명 # 사용 시점, 최대 1024자
...

MicrosoftDocs/Agent-Skills

요약

핵심 포인트

댓글