skills
무엇인가
Azure SDK와 Microsoft Foundry를 다루는 코딩 에이전트에 언어별 도메인 지식을 주입하는 스킬 묶음이다. 개별 스킬은 특정 서비스의 클라이언트 초기화, 인증, 재시도, 페이징, 직렬화 같은 구현 규칙을 규정하고, 에이전트가 해당 서비스 코드를 작성할 때 그 규칙을 따르게 한다.
어떻게 동작하나
스킬은 `.github/skills/` 아래 스킬별 디렉터리로 두고, 언어별 플러그인 번들(`.github/plugins/azure-sdk-python` 등)이 skills·commands·agents를 함께 담는다. 스킬 이름 뒤에 `-py`, `-dotnet`, `-ts`, `-java`, `-rust` 접미사를 붙여 대상 언어를 구분하며, 에이전트는 자신의 스킬 디렉터리를 로드해 작업 중 해당 규칙을 참조한다. 저장소 루트의 `AGENTS.md`는 에이전트 설정 템플릿, `.vscode/mcp.json`은 MCP 서버 구성, `.github/agents/`와 `.github/prompts/`는 페르소나와 프롬프트 템플릿을 담는다.
무엇과 다른가
프롬프트를 매번 직접 쓰거나 단일 규칙 파일에 모든 지침을 몰아넣는 방식과 달리, 언어·서비스 단위로 스킬을 분리해 필요한 것만 선택 설치한다. 스킬 디렉터리를 심볼릭 링크로 공유하면 `.github/skills`, `.claude/skills`, `.opencode/skills`처럼 에이전트별 설정 경로가 달라도 같은 규칙 집합을 참조하게 할 수 있다. 문서 스크래핑 워크플로가 `docs/llms.txt`를 매일 갱신하는 구조도 함께 들어 있다.
어떻게 쓰나
`npx skills add microsoft/skills`를 실행하면 마법사에서 스킬을 고르고, 선택한 스킬이 대상 에이전트의 디렉터리(예: GitHub Copilot은 `.github/skills/`)에 설치된다. 여러 에이전트를 쓴다면 심볼릭 링크로 연결된다. Copilot CLI에서는 `/plugin marketplace add microsoft/skills` 후 `/plugin install azure@skills` 같은 슬래시 명령으로 플러그인 단위 설치가 가능하고, git clone 후 `cp -r`로 특정 스킬만 복사하는 수동 설치도 지원한다.
전제와 한계
GitHub Copilot(VS Code·CLI)을 기준으로 하며, 심볼릭 링크를 통해 Claude Code·opencode 등 다른 에이전트 설정에도 붙일 수 있다. 저장소는 개발 진행 중이고 Foundry 관련 스킬은 프리뷰다. 모든 스킬을 한꺼번에 로드하면 컨텍스트가 희석되고 토큰이 낭비되므로 현재 프로젝트에 필요한 스킬만 설치해야 한다. 스킬이 올바른 코드 패턴을 만드는지는 GitHub Copilot SDK 기반 테스트 하네스로 검증한다.
관련 논문 1
유사 스킬
- agent-skillsAI 코딩 에이전트에 카테고리별 SKILL.md 규칙 묶음을 설치해 워크플로·패턴·검증 절차를 주입하는 관리형 스킬 레지스트리 CLI다.
- skills격리된 워크트리에서 시작해 서비스 계층으로 구현하고, 증거로 증명한 뒤 before/after 표와 Greptile 리뷰 루프로 마무리하는 4박자 워크플로를 SKILL.md 묶음으로 주입한다.
- dotagents.agents 폴더를 단일 원본으로 두고 CLAUDE.md·AGENTS.md·commands·hooks·skills를 각 에이전트 경로에 심링크로 연결해 규칙 파일이 갈라지는 것을 막는다.
- grokbot-field-notesAGENTS.md 한 파일로 에이전트에 단일 역할 부여, 수정 전 버그 재현, 증거 첨부, 검증 루프 우선 같은 작업 규칙을 주입한다.