wikiline.dev
·
Wikiline › AI (인공지능) › AI 에이전트 스택 › 에이전트 스킬 (Agent Skills)

에이전트 스킬 (Agent Skills)

타임라인 6건업데이트 1건갱신 2026-09-27별칭: Agent Skills, SKILL.md, 스킬, Claude 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 등)도 함께 공개됨. (출처, 출처)

벤더별 비교

구분 Anthropic (Claude) OpenAI (Codex) Google (Gemini CLI) Cursor GitHub Copilot
명칭 Agent Skills Codex Skills Agent Skills (Preview) Skills (.agents/skills) Agent Skills
포맷 SKILL.md (원조) SKILL.md (agentskills.io 준수) SKILL.md (agentskills.io 준수) SKILL.md (agentskills.io 준수) SKILL.md, .claude/skills 자동 인식
호출 방식 자동 선택 + 명시 호출 /skills, $ 멘션 또는 자동 자동 선택 자동 선택 프롬프트 관련성 기반 자동
배포 단위 개인/조직 프로비저닝, Claude Code 플러그인 openai/skills 카탈로그 Gemini CLI 확장 내 포함 가능 리포지토리 내 폴더 Copilot coding agent / CLI / VS Code
조직 관리 관리자 콘솔 중앙 배포(2025-12~) 미공개 미공개 미공개 미공개

잘 쓰는 법

  • 스킬은 "지식/절차"를, MCP는 "외부 시스템 연결"을, 서브에이전트는 "독립된 실행 컨텍스트"를 담당합니다 — 셋을 혼동해 하나에 다 넣지 말 것.
  • SKILL.md의 description은 에이전트가 스킬을 고를 때 보는 유일한 단서이므로, 프롬프트보다 훨씬 명확하고 구체적으로 작성해야 자동 트리거 정확도가 올라갑니다.
  • 긴 참고자료는 본문에 직접 쓰지 말고 별도 파일로 분리해 점진적 공개 구조를 살려야 컨텍스트 낭비가 없습니다.
  • 매번 반복해서 프롬프트에 붙여넣는 지침(코드 리뷰 체크리스트, 사내 문서 작성 규칙 등)은 스킬로 옮기는 게 프롬프트보다 재사용성·일관성이 높습니다.
  • Claude Code에서 만든 .claude/skills는 GitHub Copilot이 그대로 인식하므로, 한 번 만들어 두면 벤더를 옮겨도 재사용 가능합니다.
  • 실행 스크립트를 포함하는 스킬은 신뢰할 수 없는 소스에서 그대로 설치하지 말 것 — 스킬은 코드 실행 권한을 가질 수 있습니다.
  • 조직 단위로 쓸 경우 관리자가 중앙 배포한 스킬과 개인이 추가한 스킬을 구분해 관리해야 충돌·중복을 줄일 수 있습니다.

타임라인

2025-10-16 · Anthropic, Agent Skills 공개

  • 이전 대비: 최초 등장
  • Claude.ai, API, Claude Code, Claude Agent SDK에 동시 적용되는 SKILL.md 기반 스킬 시스템을 발표. 폴더 단위로 지침·스크립트·리소스를 묶어 필요할 때만 불러오는 "점진적 공개" 구조를 핵심으로 제시.
  • 출처: Claude Skills are awesome, maybe a bigger deal than MCP

2025-12-12 · OpenAI, ChatGPT·Codex CLI에 스킬 도입

2025-12-18 · Agent Skills를 오픈 표준으로 공개 (agentskills.io)

  • 이전 대비: Claude 전용 기능에서 벤더 중립 오픈 표준으로 전환. 같은 날 GitHub Copilot 지원 발표와 Claude 조직 배포/디렉터리 기능이 동시에 나옴.
  • agentskills.io를 통해 스펙과 문서를 공개, "Claude에서 동작하는 능력이 다른 AI 시스템에서도 동일하게 동작해야 한다"는 목표를 제시. OpenAI가 이 표준을 채택한다고 명시됨.
  • 출처: Anthropic publishes Agent Skills as an open standard

2025-12-18 · GitHub Copilot, Agent Skills 지원 발표

  • 이전 대비: 서드파티 코딩 어시스턴트 중 첫 공식 채택. Claude Code의 .claude/skills 폴더를 별도 작업 없이 그대로 인식.
  • Copilot coding agent, Copilot CLI, VS Code Insiders(정식 VS Code는 2026년 1월)에서 스킬 지원. anthropics/skills, github/awesome-copilot 등 커뮤니티 저장소 스킬 재사용 가능.
  • 출처: GitHub Copilot now supports Agent Skills

2026(추정, 상반기) · Cursor, .agents/skills 지원 추가

  • 이전 대비: 코딩 에이전트 진영 세 번째(Copilot 다음) 채택 사례로, 어떤 코딩 에이전트에서도 동일 스킬을 쓸 수 있게 하는 것을 목표로 명시.
  • Cursor 팀이 .agents/skills 경로 지원을 발표하며 "어떤 코딩 에이전트와도 스킬을 쓰기 쉽게 만든다"는 목적을 밝힘.
  • 출처: Lee Robinson, X 게시물

2026(추정) · Google Gemini CLI, Agent Skills 프리뷰 도입

  • 이전 대비: Google 진영에도 동일 SKILL.md 규격 도입, Gemini CLI 확장(Extensions) 체계와 결합.
  • Gemini CLI에 Agent Skills(Preview) 기능이 추가되어 확장 패키지 안에 스킬을 포함해 배포할 수 있게 됨.
  • 출처: Agent Skills | Gemini CLI

출처

  • Simon Willison, "Claude Skills are awesome, maybe a bigger deal than MCP" (2025-10-16)
  • SiliconANGLE, "Anthropic's Skills for Claude helps AI agents perform certain tasks better than before" (2025-10-16)
  • The Decoder, "Anthropic publishes Agent Skills as an open standard for AI platforms" (2025-12-18)
  • Claude by Anthropic, "Skills for organizations, partners, the ecosystem" (2025-12-18, claude.com/blog/organization-skills-and-directory)
  • GitHub Changelog, "GitHub Copilot now supports Agent Skills" (2025-12-18)
  • GitHub Changelog, "Copilot code review: Agent skills and MCP now generally available" (2026-07-29)
  • Lee Robinson(Cursor), X 게시물, .agents/skills 지원 발표 (2026, 날짜 미확정)
  • Google, "Agent Skills | Gemini CLI" 공식 문서 (geminicli.com)
  • Blockchain News, "OpenAI Codex Adds Skills Support Following AgentSkills.io Standard" (2026)
  • bex.co, "OpenAI Adopted Anthropic's Agent Skills Format in 48 Hours" (2026-07-31)
  • OpenAI Developers, "Build skills | Codex" 공식 문서 (developers.openai.com/codex/skills)
  • Anthropic, "Introducing Agent Skills" 공식 발표 (anthropic.com/news/skills)

관련 주제

플러그인 & 마켓플레이스 (Plugins & Marketplaces)MCP (Model Context Protocol)서브에이전트 & 멀티에이전트 (Subagents & Multi-Agent Systems)