Molayo

© 2026 Molayo

Qiita헤드라인2026. 05. 24. 15:20

Claude Skills──OpenAI가 선제적으로 구현했던 SKILL.md 초소형 표준

요약

Anthropic이 오픈 표준화한 Claude Skills는 에이전트의 작업 절차를 정의하는 초소형 사양입니다. SKILL.md라는 단순한 파일 형식을 통해 메타데이터와 지시문을 전달하며, MCP와 보완 관계를 통해 에이전트의 실행 능력을 극대화합니다.

핵심 포인트

  • SKILL.md는 YAML과 Markdown을 활용한 초소형 에이전트 스킬 표준
  • 단계적 공개(Progressive Disclosure) 메커니즘으로 토큰 효율성 극대화
  • MCP가 '연결'을 담당한다면, Skills는 '수행 절차'를 담당하는 보완 관계
  • Vercel skills.sh에 단기간 내 40만 건의 스킬이 등록되며 급속 확산

2025년 12월 18일, Anthropic이 Claude Skills(Agent Skills)를 오픈 표준화했다. 같은 날 Microsoft가 GitHub Copilot에서의 대응을 발표했으며, 그 6일 전에는 OpenAI가 ChatGPT와 Codex CLI에 동일한 SKILL.md 형식을 비밀리에 구현했다는 사실이 Elias Judin 씨에 의해 발견되었다. 직접적인 경쟁 관계에 있는 대형 3사가 Anthropic의 오픈 표준화 전후 수일 만에 동일한 파일 형식으로 모이게 된 형국이다. 2026년 3월 시점에 32개의 툴이 대응하였고, 5월에는 Vercel의 마켓플레이스 skills.sh에 약 40만 건의 skills가 등록되었다. 이는 npm이 약 7년(2017년 1월 기준) 동안 도달한 35만 건 규모를 약 4개월 만에 추월한 수치다. 내용은 SKILL.md라는 파일 형식으로, 폴더에 YAML이 포함된 Markdown 파일을 한 장 두는 것만으로 구성된 초소형 사양이다. 왜 이렇게까지 확산되었으며, 설계의 어떤 점이 효과적인지 분석해 본다.

Skill은 에이전트(Agent)에게 "특정 태스크를 이렇게 진행해"라고 전달하기 위한 그릇이다. 최소 단위는 폴더 하나다. 그 안에 SKILL.md를 두고, 필요하다면 보조 스크립트나 참고 자료를 같은 계층에 나열한다. 내용은 YAML 메타데이터와 지시문뿐이며, 필수 필드는 name과 description 두 가지뿐이다 (agentskills.io 공식 사양 기준).

디렉터리 구조와 최소 예시는 다음과 같다.

pdf-processing/
├── SKILL.md # YAML frontmatter + 지시문(필수)
├── scripts/ # 실행 가능한 코드(임의)
...

---
name: pdf-processing
description: Extract PDF text, fill forms, merge files. Use when handling PDFs.
...

이것만으로 하나의 스킬이 완성된다. setup.py도 없고, Dockerfile도 필요 없다. 저명한 독립 엔지니어인 Simon Willison은 이 사양을 "deliciously tiny(황홀할 정도로 작은)"라고 평하면서도, "quite heavily under-specified(상당히 사양이 부족함)"라고 쓰기도 했다.

설계의 핵심은 정보를 3단계로 나누어 읽어들이는 메커니즘이다. Anthropic은 이를 단계적 공개 (progressive disclosure)라고 부른다.

  • 제1계층·메타데이터 (상시): name과 description만이 에이전트 기동 시에 읽힌다. 1스킬당 약 100 토큰이며, 50개의 스킬을 넣어도 합계 약 5,000 토큰 정도다 (agentskills.io 공식 사양 기준).
  • 제2계층·본체 (발동 시)
  • 제3계층·보조 리소스 (필요 시): scripts/나 references/ 내의 파일은 본체에서 참조되었을 때만 읽힌다.

그 효과는 Rakuten의 공식 코멘트에서 수치로 나타나고 있다. 해당 회사의 AI 담당 제너럴 매니저인 Yusuke Kaji 씨는 Anthropic 블로그에서 "Claude가 여러 개의 스프레드시트를 처리하고, 우리의 절차에 따라 리포트를 생성한다. 하루가 걸리던 작업이 1시간 만에 끝난다"라고 언급했다. 이는 약 87%의 시간 절감에 해당한다.

같은 Anthropic이 만드는 MCP와 Skills는 자주 혼동된다. MCP는 "GitHub나 Slack 등 외부 서비스로의 접속"을, Skills는 "접속 후 그 툴을 어떻게 사용하고 어떤 절차로 업무를 진행할 것인가"를 해결하는 별개의 것이다. MCP가 "무엇을 할 수 있는지"를 제공한다면, Skills는 "어떻게 진행할지"를 전달한다. 양자는 보완 관계에 있으며, MCP로 GitHub에 연결하고 Skills로 "사내 코드 리뷰 규약에 따른 지적 방식"을 학습시키는 식의 조합이 자연스럽다.

시계열로 나열하면 표준화 전후의 움직임이 얼마나 이례적인지 알 수 있다.

  • 2025년 12월 12일 (발견): OpenAI가 ChatGPT와 Codex CLI에 동일한 SKILL.md 형식을 비밀리에 구현했다는 사실이 Elias Judin 씨에 의해 발견되었으며, Simon Willison이 재검증함
  • 2025년 12월 18일: Anthropic이 Skills 사양을 agentskills.io

를 통해 오픈 소스화하고, 레퍼런스 SDK도 공개했다. 같은 날 GitHub Copilot도 Agent Skills 지원을 발표했다 (GitHub Changelog).

  • 2026년 1월 8일: Microsoft VS Code 1.108(stable)이 Agent Skills 지원
  • 2026년 3월 시점: Cursor, Block Goose, Gemini CLI, JetBrains Junie, AWS Kiro를 포함한 32개 도구가 지원 (Paperclipped 집계)
  • 2026년 5월 시점: skills.sh에 약 40만 건의 skills 등록

OpenAI의 채택은 공식 발표를 동반하지 않는 "quiet adoption"이었으며, The Decoder지는 「OpenAI quietly adopts Anthropic's modular skills framework」라고 보도했다. 직접적인 경쟁 관계에 있는 OpenAI와 Microsoft가 Anthropic의 오픈 표준화 전후 며칠 만에 동일한 파일 형식으로 모인 것은 AI 인프라 업계에서 보기 드문 광경이며, 공식 리포지토리 anthropics/skills는 5월 시점에 약 139K 스타(star)에 도달했다.

참고로 각 도구에서 skills를 두는 경로는 다르다. Claude Code는 ~/.claude/skills/, OpenAI Codex는 ~/.agents/skills/ (또는 리포지토리 내의 .agents/skills), Gemini는 ~/.gemini/antigravity/skills/이다. "파일 형식은 통일되었지만, 배치까지 표준화되지는 않았다"는 점에는 주의해야 한다.

지금까지 사양과 표준화에 대해 이야기해 왔지만, 실제 운용에서 어떤 일이 일어나고 있는지를 보여주는 좋은 사례가 미국의 헤지펀드 Walleye Capital이다. Anthropic 공식 블로그에 따르면, 약 400명의 전 직원이 업무에서 Claude Code를 이용하고 있으며, 피치북(pitchbook) 작성, 결산 리뷰, KYC 심사, 월간 결산, 평가 리뷰 등 Anthropic이 제공하는 10종류의 재무 템플릿(skills 기반)을 업무 흐름에 통합하여 사용하고 있다.

400명 규모의 조직에서 100% 채택이라는 것은 기업용 AI 도구 도입 사례 중에서도 좀처럼 보기 힘든 수치다. 보통 AI의 사내 침투율은 수십 %에서 정체되기 마련이다. Walleye의 사례가 보여주는 것은, AI가 무엇을 할 수 있는지 한 명씩 가르치는 것이 아니라, 업무 절차 그 자체를 skill로서 배포함으로써 누가 사용하더라도 동일한 품질의 업무가 돌아가게 만드는 채택 방식이다. Skills의 "파일 한 장을 두는 것만으로"라는 극도의 간결함이 사내에 배포할 때의 마찰을 거의 제로로 만들고 있다.

Skills의 설계에는 "폴더에 markdown을 두기만 하면 된다"라는 놀라울 정도로 소박한 태도가 관통되어 있다. 하지만 그 극도의 간결함이 표준화 전후의 짧은 기간 동안 경쟁사인 OpenAI를 포함한 대형 3사, 5개월 만에 32개 도구, 그리고 Walleye Capital 전사 채택이라는 규모를 만들어냈다. 사내에 AI 에이전트(Agent)를 도입하고 싶다면, 우선 기존의 체크리스트나 코딩 규약을 한 장의 SKILL.md에 작성하여 Git에 커밋하는 것부터 시작할 수 있다. "무엇을 할 수 있는가"를 기능으로 설명하는 것보다 "어떻게 진행하는가"를 절차로 전달하는 것이 에이전트가 일을 하게 만든다. 다음에 이 방식으로 표준화될 것은, 어떤 "작동 방식"일까?

AI 자동 생성 콘텐츠

본 콘텐츠는 Qiita AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.

원문 바로가기
0

댓글

0