에이전트 스킬 (Agent Skills)

한 줄 정의

SKILL.md를 중심으로 지침·스크립트·리소스를 폴더 단위로 묶어, 에이전트가 필요할 때만 점진적으로 불러 쓰는 재사용 가능한 능력 패키징 방식.

지금 상태 (2026-09 기준)

2025년 10월 Anthropic이 Claude에 도입한 뒤, 같은 해 12월 agentskills.io 오픈 표준으로 공개되면서 OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI가 잇따라 같은 포맷(SKILL.md)을 지원하기 시작했습니다. 사실상 "프롬프트 대신 파일로 능력을 배포"하는 업계 공통 규격으로 자리잡는 중이며, Claude 쪽은 Team/Enterprise 조직 단위 배포·커넥터 디렉터리까지 확장했습니다. 아직 실행 권한·보안 검증 체계는 벤더마다 제각각이라 표준화 초기 단계로 봐야 합니다.

개념

스킬은 폴더 하나로, 최소 SKILL.md(YAML 프런트매터 + 지침 본문) 한 개와 선택적으로 스크립트·참고자료·템플릿을 포함합니다. 핵심 아이디어는 "점진적 공개(progressive disclosure)": 에이전트는 항상 모든 스킬의 이름·설명(메타데이터)만 먼저 로드해 두고, 사용자 요청과 관련 있다고 판단될 때만 해당 SKILL.md 본문을 읽고, 그 안에서 참조하는 스크립트·문서는 실제로 실행 단계에 이르러서야 불러옵니다. 이 3단계(메타데이터 → 지침 → 리소스) 구조 덕분에 수십~수백 개 스킬을 등록해도 컨텍스트 낭비 없이 확장할 수 있습니다. Claude 쪽 활용 범위는 Claude.ai(Pro/Max/Team/Enterprise), API(/v1/skills 엔드포인트를 포함한 Messages API), Claude Code(플러그인 형태 배포 포함), Claude Agent SDK 전반을 아우릅니다.

[업데이트 2025-12-18] Anthropic이 Agent Skills를 agentskills.io 오픈 표준으로 공개. 같은 날 GitHub Copilot이 Agent Skills 지원을 발표했고, Claude Team/Enterprise 관리자가 조직 차원에서 스킬을 중앙 배포하는 기능과 파트너 스킬 디렉터리(claude.com/connectors — Atlassian, Canva, Figma, Cloudflare, Sentry, Vercel, Zapier 등)도 함께 공개됨. (출처, 출처)

[업데이트 2026-10-28] Google은 자사 Agent Skills 저장소(스킬 170개 이상)를 제품처럼 출시한다고 밝혔다. 모든 변경에 시맨틱 버전과 평가 리포트를 요구하고, 사람 승인 전에 구조 검사·린터·버전 검사·평가 검증·링크 검증·AI 리뷰 에이전트 등 6개 자동 게이트를 통과시킨다. 리뷰 기준에는 SKILL.md 본문 500줄 이하 유지, 결정적 절차는 scripts/로 분리가 포함된다. (출처)

[업데이트 2026-11-03] Google Cloud는 SKILL.md를 한 번 돌려 통과시키는 식의 검증 대신, 스킬 사용/미사용을 쌍으로 비교해 여러 번 반복 측정(Pass@3)하고 정확성·효율·보안 점수를 분리하라고 권한다. 효과가 없는 스킬은 컨텍스트만 차지하므로 모델 업그레이드 뒤 효과가 0이면 지우라는 조언도 있다. 오픈소스 CLI skill-reach(lint·overlap·eval·optimize)가 함께 소개됐다. (출처)

[업데이트 2026-11-05] Google Cloud는 AlphaEvolve로 SKILL.md를 반복 재작성하고 Terminal-Bench 2.0 과제에서 코딩 에이전트를 실행해 점수를 매기는 스킬 최적화 방식을 소개했다. 보고된 향상은 약 5%였고, 에이전트의 가장 흔한 실패(시간 초과)를 겨냥한 스킬이 가장 좋았다. 일반적인 기본 스킬은 성능 차이를 내지 못했다. (출처)

[업데이트 2026-11-10] Chrome·Edge·Firefox·MDN 팀이 관리하는 Modern Web Guidance는 코딩 에이전트에게 최신 웹 표준 모범사례와 브라우저 호환성 정보를 주는 스킬 모음이다. Claude·Codex·Cursor·Gemini 등 에이전트별 플러그인 매니페스트와 설치 CLI로 배포된다(Apache-2.0). (출처)

[업데이트 2026-11-13] Google Cloud가 SC26 발표에서 HPC용 에이전트 스킬을 소개했다. Cluster Toolkit 배포 전 쿼터·용량을 점검하고 사람 승인을 기다리는 인프라 스킬, CFD·생명과학 워크로드 스킬 등을 Google Skills·DeepMind Science Skills GitHub 저장소로 내려받게 한다. 각 스킬의 GA/프리뷰 여부는 글에 명시돼 있지 않다. (출처)

벤더별 비교

잘 쓰는 법

• 스킬은 "지식/절차"를, MCP는 "외부 시스템 연결"을, 서브에이전트는 "독립된 실행 컨텍스트"를 담당합니다 — 셋을 혼동해 하나에 다 넣지 말 것.
  • 예: "Notion 문서를 읽어와 코드 리뷰 체크리스트대로 정리해라"라는 작업이라면, Notion 접근은 MCP 서버가, 체크리스트 절차는 스킬이 맡도록 나누는 것이 맞습니다 — 스킬 안에 Notion API 호출 코드를 통째로 넣으면 유지보수가 꼬입니다.
• SKILL.md의 description은 에이전트가 스킬을 고를 때 보는 유일한 단서이므로, 프롬프트보다 훨씬 명확하고 구체적으로 작성해야 자동 트리거 정확도가 올라갑니다.
  • 예: description을 "문서 작업 도움"처럼 모호하게 쓰면 관련 없는 요청에도 스킬이 잘못 호출될 수 있지만, "PDF 양식에서 특정 필드를 추출해 CSV로 저장할 때 사용"처럼 구체적으로 쓰면 꼭 필요한 순간에만 선택됩니다.
• 긴 참고자료는 본문에 직접 쓰지 말고 별도 파일로 분리해 점진적 공개 구조를 살려야 컨텍스트 낭비가 없습니다.
  • 예: 사내 API 명세 수백 줄을 SKILL.md 본문에 다 적으면 스킬을 쓰지 않는 요청에서도 매번 로드될 수 있으니, API 명세는 reference.md로 분리해 실제로 필요할 때만 불러오게 합니다.
• 매번 반복해서 프롬프트에 붙여넣는 지침(코드 리뷰 체크리스트, 사내 문서 작성 규칙 등)은 스킬로 옮기는 게 프롬프트보다 재사용성·일관성이 높습니다.
  • 예: 매 PR마다 "변수명은 camelCase, 커밋 메시지는 한글로" 같은 규칙을 대화창에 복붙하던 걸 스킬 하나로 만들어두면, 팀원 전체가 같은 버전을 공유하고 매번 다시 설명할 필요가 없습니다.
• Claude Code에서 만든 .claude/skills는 GitHub Copilot이 그대로 인식하므로, 한 번 만들어 두면 벤더를 옮겨도 재사용 가능합니다.
  • 예: Claude Code용으로 만든 .claude/skills/code-review 폴더를 그대로 둔 채 같은 저장소를 Copilot coding agent로 작업해도 별도 변환 없이 같은 스킬이 동작합니다.
• 실행 스크립트를 포함하는 스킬은 신뢰할 수 없는 소스에서 그대로 설치하지 말 것 — 스킬은 코드 실행 권한을 가질 수 있습니다.
  • 예: GitHub에서 찾은 출처 불명 스킬을 그대로 설치해 실행했다가, 내부에 포함된 셸 스크립트가 자격증명을 외부로 전송하는 코드였다는 것을 뒤늦게 발견하는 식의 사고가 날 수 있습니다.
• 조직 단위로 쓸 경우 관리자가 중앙 배포한 스킬과 개인이 추가한 스킬을 구분해 관리해야 충돌·중복을 줄일 수 있습니다.
  • 예: 회사 관리자가 "코드 리뷰 체크리스트" 스킬을 전사 배포했는데 개인이 같은 이름으로 또 다른 버전을 로컬에 설치하면, 어느 쪽이 실제로 적용되는지 혼란이 생길 수 있습니다.