Microsoft Agent Skills 소개
Microsoft가 공개한 Agent Skills 는 AI 코딩 에이전트(예: GitHub Copilot, Claude 등)가 Azure SDK 및 Microsoft AI Foundry와 같은 특정 도메인 지식을 정확하게 이해하고 활용할 수 있도록 돕는 모듈형 지식 패키지 및 MCP(Model Context Protocol) 구성 라이브러리입니다.
Microsoft Agent Skills 프로젝트는 맥락 주도 개발(Context-Driven Development) 이라는 개념을 바탕으로 합니다. 일반적으로 대규모 언어 모델(LLM)은 사전 학습된 데이터에 의존하기 때문에 최신 라이브러리의 변경 사항이나 특정 API의 정확한 사용법(패턴)을 모르는 경우가 많습니다. 이를 Context Rot(맥락 부패)라고 부르며, 이로 인해 에이전트가 잘못된 코드를 생성하거나 환각(Hallucination)을 일으킬 수 있습니다.
Agent Skills는 이러한 문제를 해결하기 위해 에이전트에게 필요한 신선한 지식(Fresh Knowledge)을 제공합니다. 개발자는 사용하는 에이전트 종류에 따라, 필요한 스킬(Skill)을 적절한 스킬 디렉토리(예. Claude Code의 경우 .claude/skills/ 등)에 추가하기만 하면 됩니다. 각 스킬에는 해당 라이브러리를 올바르게 사용하는 방법, 모범 사례, 주의 사항 등이 SKILL.md 파일에 정의되어 있어, 에이전트가 코드를 작성할 때 이 지침을 참고하여 전문가 수준의 코드를 생성할 수 있게 됩니다.
현재 이 라이브러리는 Python, .NET, TypeScript, Java 등 다양한 언어 환경을 지원하며, 130개 이상의 스킬과 커스텀 에이전트 템플릿을 제공하고 있습니다.
Microsoft Agent Skills의 주요 특징
이 프로젝트는 크게 Skills(스킬), Custom Agents(커스텀 에이전트), 그리고 MCP 설정으로 구성되어 있습니다.
Skills (모듈형 지식 패키지)
스킬은 에이전트가 특정 작업을 수행하는 데 필요한 지식의 집합입니다. 현재 130개 이상의 스킬이 제공되며, 언어별로 접미사(-py, -dotnet, -ts, -java)가 붙어 있습니다.
- 구조: 각 스킬은
.github/skills/내의 독립된 디렉터리로 존재하며, 핵심은SKILL.md파일입니다. 이 파일에는 에이전트가 따라야 할 지침(Instructions), 트리거(Triggers), 예제 코드가 포함됩니다. - 주요 카테고리:
- Foundry & AI:
azure-ai-projects-py(AI Foundry 프로젝트 관리),azure-ai-openai-dotnet(Azure OpenAI 클라이언트) 등. - Data & Storage:
azure-cosmos-db-py(Cosmos DB 패턴),azure-storage-blob-py(Blob 스토리지) 등. - Core (핵심):
azd-deployment(Azure Container Apps 배포),mcp-builder(MCP 서버 구축 가이드),skill-creator(새로운 스킬 제작 가이드).
Custom Agents (커스텀 에이전트 템플릿)
특정 역할에 최적화된 에이전트 설정을 제공합니다. AGENTS.md 템플릿을 통해 프로젝트 내에서 에이전트의 역할과 행동 지침을 정의할 수 있습니다.
- Backend Agent: FastAPI, Pydantic, Azure SDK 등을 활용한 백엔드 개발 전문.
- Frontend Agent: React, TypeScript, Tailwind CSS 등을 활용한 UI 개발 전문.
- Infrastructure Agent: Bicep, Azure CLI 등을 활용한 인프라 구성 전문.
MCP (Model Context Protocol) 지원
LLM이 외부 데이터나 도구와 상호작용할 수 있도록 돕는 MCP 서버 구성을 제공합니다.
- Microsoft Docs: 공식 문서를 검색하여 최신 API 패턴을 확인할 수 있는 MCP 서버.
- GitHub: 이슈 및 PR 관리를 위한 MCP.
- Context7: AI Foundry 문서를 시맨틱 검색으로 조회할 수 있는 인덱스.
Microsoft Agent Skills 사용 방법
개발자는 CLI 도구를 사용하거나 수동으로 파일을 복사하여 스킬을 프로젝트에 적용할 수 있습니다.
npx 가 설치되어 있다면 다음과 같은 CLI 명령어를 실행하면 마법사가 실행되어 필요한 스킬을 선택하고 프로젝트에 추가할 수 있습니다:
npx skills add microsoft/skills
또는, 직접 GitHub 저장소에서 필요한 스킬 폴더(예: azure-cosmos-db-py)를 복사하여 내 프로젝트의 적절한 에이전트별 스킬 경로(예. Claude Code의 경우 .claude/skills/)에 붙여넣습니다.
이후, Claude Code 또는 GitHub Copilot 등에서 작업을 요청하면(예: "Cosmos DB에 데이터를 저장하는 API를 만들어줘"), 에이전트는 .github/skills/에 있는 관련 스킬(azure-cosmos-db-py)의 SKILL.md를 읽고, 그 안에 정의된 모범 사례(Best Practices)에 따라 코드를 작성합니다.
라이선스
Microsoft Agent Skills 프로젝트는 MIT 라이선스로 공개 및 배포되고 있습니다.
Microsoft Agent Skills 프로젝트 홈페이지
Microsoft Skills 프로젝트 GitHub 저장소
이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다. 
파이토치 한국 사용자 모임
이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일
로 보내드립니다! (기본은 Weekly지만 Daily로 변경도 가능합니다.)
아래
쪽에 좋아요
를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ 