AI 코딩 · 2026년 7월 7일 · 약 7분

Microsoft .NET Agent Skills 사용법, AI 코딩 에이전트에 팀 규칙을 붙이는 방법

Microsoft .NET 팀의 dotnet/skills 저장소가 Copilot CLI, Claude Code, Codex 같은 코딩 에이전트에서 반복 작업을 스킬로 다루는 흐름을 보여준다. .NET 개발자가 처음 적용할 만한 설치 순서와 안전한 사용 기준을 정리했다.

Microsoft .NET Agent Skills
dotnet skills
AI 코딩 에이전트
Codex CLI 스킬
Claude Code 스킬

출처: .NET Team GitHub

Microsoft의 .NET 팀이 운영하는 dotnet/skills 저장소는 .NET과 C# 작업을 돕는 AI 코딩 에이전트용 스킬 모음입니다. 저장소 설명과 README에 따르면 이 프로젝트는 .NET 팀이 선별한 핵심 스킬과 커스텀 에이전트를 담고 있으며, Copilot CLI, Claude Code, VS Code, Cursor, Codex CLI에서 쓰는 설치 흐름을 안내합니다.

초보 개발자에게 중요한 점은 “AI에게 더 똑똑하게 말하는 법”보다 “반복되는 개발 규칙을 한 번 정리해 에이전트가 매번 읽게 하는 법”입니다. 테스트 실행, MSBuild 오류 분석, Entity Framework 점검, .NET 업그레이드처럼 자주 반복되는 업무는 매번 긴 프롬프트를 쓰기보다 스킬로 묶어 두는 편이 실수도 적고 팀 안에서 공유하기도 쉽습니다.

핵심 키워드

Microsoft .NET Agent Skills
dotnet/skills 사용법
AI 코딩 에이전트 스킬
Claude Code .NET
Codex CLI 스킬 설치

무엇을 제공하나

README 기준으로 dotnet/skills에는 dotnet, dotnet-data, dotnet-msbuild, dotnet-test, dotnet-upgrade, dotnet-ai, dotnet-aspnetcore 같은 플러그인이 포함됩니다. 각 플러그인은 특정 개발 상황에서 에이전트가 따라야 할 절차와 확인 기준을 담습니다. 예를 들어 테스트 관련 플러그인은 실행, 필터링, 분석, 개선 흐름을 다루고, dotnet-ai는 LLM 통합, RAG, MCP, ML.NET 같은 AI 개발 주제를 다룹니다.

플러그인	처음 써볼 상황	확인할 결과
dotnet-test	테스트가 실패했지만 원인이 넓게 퍼져 있을 때	실행 명령, 실패 범위, 다음 수정 후보가 분리되는지 확인
dotnet-data	Entity Framework 쿼리나 데이터 접근 코드가 느릴 때	N+1 쿼리, 추적 모드, 불필요한 로딩을 에이전트가 짚는지 확인
dotnet-msbuild	빌드 오류나 프로젝트 파일 충돌을 고칠 때	csproj, props, targets 변경 근거를 설명하는지 확인
dotnet-ai	.NET 앱에 LLM, RAG, MCP를 붙일 때	샘플 코드보다 인증, 데이터 흐름, 실패 처리 기준을 먼저 제안하는지 확인

설치 전에 먼저 정할 기준

스킬은 에이전트에게 “이 작업은 이렇게 처리하라”고 알려주는 작업 지침입니다. 그래서 많이 설치하는 것보다 내 저장소에 실제로 필요한 것부터 고르는 편이 낫습니다. .NET API 서버라면 dotnet, dotnet-test, dotnet-data 정도로 시작하고, AI 기능을 붙이는 프로젝트에서만 dotnet-ai를 더하는 식입니다.

처음 적용할 때의 순서

현재 프로젝트가 ASP.NET Core, MAUI, Blazor, 라이브러리, 테스트 프로젝트 중 어디에 가까운지 정한다.
가장 자주 실패하는 반복 작업 하나를 고른다. 예: 테스트 실패 분석, EF Core 성능 점검, .NET 업그레이드.
해당 플러그인 하나만 설치해 작은 브랜치에서 실행한다.
에이전트가 만든 변경은 바로 병합하지 말고 diff, 테스트 결과, 변경 이유를 함께 본다.
팀 규칙이 있으면 별도 AGENTS.md나 프로젝트 지침에 추가해 공식 스킬과 함께 읽히게 한다.

Copilot CLI나 Claude Code에서 시작하기

저장소 README는 Copilot CLI와 Claude Code에서 마켓플레이스를 추가하고 플러그인을 설치하는 흐름을 안내합니다. 실제 명령은 사용하는 도구 버전에 따라 달라질 수 있으므로, 먼저 저장소 README의 최신 설치 섹션을 확인하세요.

복사해 둘 설치 메모

/plugin marketplace add dotnet/skills
/plugin install dotnet-test@dotnet-agent-skills
/plugin install dotnet-data@dotnet-agent-skills
/skills 명령으로 설치된 스킬을 확인
/agents 명령으로 사용 가능한 커스텀 에이전트를 확인

Codex CLI를 쓰는 경우 README는 Codex CLI v0.121.0 이상에서 플러그인 마켓플레이스 등록 흐름을 안내합니다. 개별 스킬만 가져오는 방식도 가능하지만, 처음에는 플러그인 단위로 설치하고 불필요한 것을 줄이는 쪽이 관리하기 쉽습니다.

실무에서 바로 해볼 30분 테스트

가장 좋은 첫 실험은 “실패하는 테스트 하나를 고치기”입니다. 새 기능을 맡기기보다 이미 실패가 보이는 작업을 맡기면 에이전트 결과를 검증하기 쉽습니다. 목표는 자동 수정이 아니라, 에이전트가 팀의 .NET 도구 체인을 이해하고 재현 가능한 절차를 따르는지 보는 것입니다.

시간	할 일	판단 기준
5분	실패하는 테스트나 빌드 오류 하나를 고른다	범위가 한 프로젝트 안에 들어오는지 확인
5분	dotnet-test 또는 dotnet-msbuild 플러그인만 활성화한다	필요 없는 플러그인을 많이 켜지 않음
10분	에이전트에게 재현 명령과 실패 원인 후보를 먼저 쓰게 한다	수정 전 원인 설명이 있는지 확인
5분	패치가 생기면 테스트를 다시 실행한다	성공 여부와 변경 파일을 함께 확인
5분	팀 규칙으로 남길 부분만 AGENTS.md나 프로젝트 문서에 적는다	일회성 프롬프트가 아니라 반복 규칙으로 남김

그냥 맡기면 생기는 문제

공식 스킬은 .NET 일반 지식을 줄 수 있지만, 내 회사의 폴더 구조와 코드 리뷰 기준까지 자동으로 알지는 못합니다. 예를 들어 저장소가 리포지터리 패턴을 쓰지 않거나, 모든 API가 Result 타입을 반환하거나, 테스트 이름 규칙이 따로 있다면 그 규칙은 프로젝트 지침으로 따로 제공해야 합니다.

문제	흔한 원인	수정 방법
코드 스타일이 팀과 다르다	공식 스킬만 있고 프로젝트 규칙이 없다	네이밍, 폴더, 예외 처리 규칙을 짧은 프로젝트 지침에 추가
너무 많은 파일을 고친다	작업 범위가 넓다	먼저 원인 분석만 요청하고, 수정은 한 프로젝트나 한 테스트로 제한
테스트 없이 코드를 바꾼다	검증 기준이 프롬프트에 없다	수정 전후 실행할 dotnet test 명령을 먼저 쓰게 함
보안 설정을 건드린다	권한과 금지 작업이 분리되지 않았다	비밀값, 인증, 배포 설정 변경은 사람 승인 전까지 금지

오늘 가져갈 적용 기준

Microsoft .NET Agent Skills의 가치는 “스킬을 많이 설치한다”가 아닙니다. .NET 팀이 정리한 반복 절차를 빌려와 내 프로젝트의 규칙과 합치는 데 있습니다. 이번 주에는 새 기능 전체를 맡기기보다 실패하는 테스트 하나, 느린 EF Core 쿼리 하나, 오래된 프로젝트 파일 하나를 골라 에이전트가 어떤 근거로 고치는지 확인해 보세요. 그 결과가 팀 안에서 반복될 수 있을 때 스킬은 단순 프롬프트보다 훨씬 유용해집니다.

자주 묻는 질문

Microsoft .NET Agent Skills는 .NET 개발자만 써야 하나요?

.NET과 C# 프로젝트에 가장 잘 맞습니다. 다른 언어나 프레임워크라면 같은 개념은 참고할 수 있지만, 이 저장소의 스킬은 .NET 도구 체인과 패턴을 기준으로 작성됐습니다.

Copilot CLI, Claude Code, Codex 중 하나만 지원하나요?

아닙니다. 저장소 README는 Copilot CLI, Claude Code, VS Code, Cursor, Codex CLI에서 쓰는 방법을 나눠 안내합니다. 다만 실제 지원 범위는 각 도구 버전에 따라 달라질 수 있어 설치 전 README를 확인해야 합니다.

스킬을 설치하면 코드 변경을 바로 믿어도 되나요?

그렇게 쓰면 위험합니다. 스킬은 에이전트의 작업 절차를 개선하지만, 테스트 실행, diff 검토, 보안 설정 확인은 사람이 해야 합니다. 처음에는 작은 브랜치에서 실패 재현과 테스트 통과 여부를 기준으로 판단하세요.