Claude 블로그 되짚어보기 #48 — Agent Skills, AI 도메인 지식의 표준이 된 폴더 (2025)

panicdev·2026년 4월 26일

원문 정보

  • 제목: Introducing Agent Skills
  • 링크: claude.com/blog/skills
  • 발행: 2025년 10월 16일 (12월 18일 오픈 표준화 업데이트)
  • 카테고리: Product announcements

글의 요지

Agent Skills — 폴더와 파일로 구성된 새로운 도메인 전문성 패키지 형식. SKILL.md 파일을 중심으로 한 재사용 가능한 절차 지식 + 스크립트 + 리소스의 묶음.

Skill의 본질

  • 폴더 = Skill (한 개의 SKILL.md 필수)
  • YAML frontmatter: name, description (필수)
  • Markdown 본문: 지시·예시·가이드라인
  • 선택적 파일: 추가 reference, 실행 스크립트, 데이터
my-skill/
├── SKILL.md        # 메인 (frontmatter + 지시)
├── references/     # 추가 컨텍스트 (필요 시 로드)
│   └── api.md
└── scripts/        # 실행 가능 스크립트
    └── validate.py

Progressive Disclosure (단계적 노출)

핵심 디자인 원칙:

Level 1: Metadata만 (시작 시)

  • name + description이 시스템 프롬프트에 미리 로드
  • 토큰 비용 거의 0
  • Claude가 "이 작업에 이 Skill 적용 가능" 판단

Level 2: SKILL.md 본문 (트리거 후)

  • 작업이 매칭되면 SKILL.md 전체 로드
  • 구체 지시·예시 활용

Level 3: Reference 파일 (필요 시)

  • 본문이 필요한 외부 파일 명시
  • Claude가 bash로 그 파일만 추가 로드
  • 큰 reference 파일들도 토큰 부담 0 (필요 안 하면 안 읽음)

Level 4: 스크립트 실행 (도구로)

  • 스크립트 코드는 컨텍스트에 안 들어감
  • Claude가 실행하고 출력만 받음

50개 Skill = 50× 비용 아니다

이 progressive disclosure가 의미하는 것 — Skill 갯수와 토큰 비용이 비례 안 함. 100개 Skill 설치해도 트리거된 것만 토큰 사용. 무한정 능력 추가 가능.

Anthropic이 제공하는 사전 빌드 Skill

  • xlsx: Excel 스프레드시트 (수식 포함)
  • docx: Word 문서
  • pptx: PowerPoint
  • pdf: 폼 작성·편집

이 4개가 #37 글의 "파일 생성" 기능을 정확히 뒷받침하는 Skill들. 즉 9월의 파일 생성은 이 Skill 시스템 위에서 작동했다.

사용 가능 영역

  • Claude.ai: 설정에서 활성화, 모든 사용자
  • Claude Code: ~/.claude/skills에 추가
  • Claude Agent SDK: 동일 지원
  • Claude Developer Platform: /v1/skills 엔드포인트

Skill-Creator (Skill 만드는 Skill)

  • "내 워크플로 알려줘" → Claude가 폴더 구조·SKILL.md·리소스 자동 생성
  • 수동 파일 편집 불필요
  • 메타 패턴

보안 경고

  • Skill = 코드 실행 권한 부여
  • 신뢰 소스만 설치
  • 외부 Skill은 SKILL.md, 스크립트, 의존성 모두 검토
  • 외부 네트워크 호출 주의

12월 18일 업데이트 — 오픈 표준

이 글이 나온 약 2개월 후, Agent Skills가 agentskills.io에서 오픈 표준으로 정식 발표:

  • Cross-platform portability: Claude뿐 아니라 다른 AI 시스템에서도 사용 가능
  • OpenAI도 Skills 채택 (검색 결과 인용)
  • Cursor 같은 IDE 에이전트 대상 설계
  • 공식 Skills 디렉토리 + Atlassian, Canva, Cloudflare, Figma, Notion, Ramp, Sentry 파트너 Skill
  • 조직 단위 관리: Team/Enterprise 관리자가 Skill 프로비저닝 통제

2026년에 다시 읽으며 — 내가 본 것

1. "Skills = 두 번째 MCP"의 전략

이 글이 나온 시점에서 Anthropic의 표준 정립 패턴이 명확해진다.

표준출시무엇을 정의
MCP2024년 11월AI ↔ 외부 도구 연결 프로토콜
Agent Skills2025년 10월 (이 글)AI ↔ 도메인 지식 패키징

The New Stack의 묘사가 정확하다 — "Anthropic's next bid to define AI standards" (Anthropic의 다음 표준 정의 시도).

전략적 베팅:

  • MCP 모델: 우리가 표준 정의 → 모두가 따름 → Claude가 표준 위에서 가장 잘 작동
  • Skills 모델: 같은 베팅 반복

이 베팅의 검증:

  • MCP는 1년 만에 Linux Foundation Agentic AI Foundation으로 이관 → 산업 표준 정립
  • Skills는 OpenAI도 채택 (검색 결과 인용) → 빠른 표준화 진행 중

2. "Progressive Disclosure"의 우아함

이 디자인의 진짜 통찰 — 컨텍스트를 희소 자원으로 인식.

이전 패턴:

  • 모든 도구·지식을 시스템 프롬프트에 넣음
  • 컨텍스트 윈도우 빠르게 고갈
  • 도구 추가 = 토큰 비용 증가

Skills의 패턴:

  • Level 1: name + description만 (한 줄)
  • 필요할 때만 본문 로드
  • 100개 Skill 설치해도 부담 0

이게 AI 에이전트의 확장성을 풀었다. 이전엔 "도구 너무 많으면 안 됨" 이 제약이었지만, Skills는 "도구 무한 추가 가능" 으로 만들었다.

비유 — 백과사전:

  • 전통 시스템 프롬프트: 백과사전 전체를 매번 읽음
  • Skills: 목차만 보고, 필요한 항목만 펼쳐 봄

이 모델이 인간 인지의 작동 방식과 닮았다. 우리도 모든 지식을 항상 의식하지 않고, 필요할 때 회상한다.

3. "파일 생성 기능 = Skills의 첫 응용"

#37 글에서 다룬 "Excel/Word/PPT/PDF 파일 생성" (2025년 9월)이 사실은 Skills 시스템 위에 구축됐다는 게 흥미롭다.

타임라인:

  • 2025년 9월 9일: 파일 생성 기능 미리보기 (Skills 미공개)
  • 2025년 10월 16일 (이 글): Skills 시스템 공식 공개
  • 2025년 10월 21일: 파일 생성 GA + Skills 통합

즉 Anthropic은 사용자에게 Skills 인프라를 보여주기 전에, 그 결과물(파일 생성)을 먼저 검증시켰다. 영리한 출시 순서:

  1. "AI가 Excel 파일 만들 수 있다" (사용자 가치 입증)
  2. "이걸 가능하게 한 인프라가 Skills" (개발자에게 공개)
  3. "여러분도 자기 도메인 Skill 만드세요" (생태계 확장)

같은 패턴이 Skill-Creator에도 적용. Anthropic이 Skills를 만들 때 자기가 만든 Skill-Creator를 사용. 도그푸딩 사례를 외부에 공개.

4. "Plugin과의 관계 정리"

이 글이 나오기 1주일 전 (10월 9일) Plugins가 출시됐다 (#45 글). 두 시스템의 관계가 헷갈렸다.

차이가 명확해진 건 시간이 지난 후:

항목PluginSkill
범위Claude Code 전용모든 Claude 제품 (cross-platform)
묶는 것슬래시 명령, 서브에이전트, MCP, hook도메인 지식 + 스크립트
형식.claude-plugin/marketplace.jsonSKILL.md + 폴더
표준Claude Code 컨벤션오픈 표준 (12월 18일)

조합 가능:

  • Plugin이 Skill 포함 가능
  • 한 마켓플레이스에 둘 다 호스팅
  • Claude Code에서 둘 다 자동 로드

2026년 시점 우위:

  • Skills > Plugins: portability, 오픈 표준, cross-platform
  • Plugins: 여전히 Claude Code 전용 묶음 (MCP, hook 같은 Code 고유 기능 포함)

5. "20개 파트너 Skill"의 생태계 가속

12월 18일 업데이트의 핵심 — 파트너 Skill 디렉토리:

  • Atlassian: Jira/Confluence 워크플로 (스펙 → 백로그, 상태 보고)
  • Canva: 디자인 자동화
  • Cloudflare: 인프라 관리
  • Figma: 디자인 시스템
  • Notion: 문서 워크플로
  • Ramp: 회계·재무
  • Sentry: 버그 자동 수정

이 생태계가 보여주는 것 — B2B SaaS 회사들이 Anthropic Skill 생태계에 자기 전문성 패키징.

비유:

  • Apple App Store: 앱 개발자가 iOS에 자기 앱 출시
  • Anthropic Skills: SaaS 회사가 자기 도메인 지식을 Skill로 출시

이 모델의 함의:

  • 사용자: "Notion 사용법" 외울 필요 없음 → Notion Skill이 가르쳐줌
  • SaaS 회사: 자기 도구의 진입 장벽 낮춤 (학습 곡선 0)
  • Anthropic: 모든 SaaS의 표준 인터페이스가 됨

이게 Anthropic이 OpenAI와 다른 길을 가는 이유다. OpenAI = 단일 인터페이스 (ChatGPT). Anthropic = 모든 도구가 Claude 위에서 더 잘 작동.

6. "조직 단위 관리"의 엔터프라이즈 진입

12월 18일 업데이트의 또 다른 핵심 — Team/Enterprise 관리자 통제.

이전:

  • 사용자가 자기 Skill 설치
  • 조직 차원 거버넌스 없음
  • 보안·일관성 우려

이후:

  • 관리자가 승인된 Skill만 프로비저닝
  • 사용자는 통제된 카탈로그에서 선택
  • 회사 정책 강제 가능

이게 enterprise 도입의 결정적 잠금 해제다. CIO가 "Skill 설치 마구잡이로 못 함" 보장 받음. 이전 글들 (#42 #43 #47) 의 enterprise readiness 마지막 퍼즐 중 하나.

7. "OpenAI도 Skills 채택" 의 의미

12월 18일 발표의 가장 충격적인 디테일 — OpenAI가 Anthropic의 Skills 표준 채택.

이게 의미하는 것:

  • AI 산업이 공통 표준 으로 수렴
  • Anthropic이 제정한 표준이 시장 검증
  • 사용자 데이터·도메인 지식이 모델 락-인 안 됨

산업적 함의:

  • Skill 한 번 만들면 ChatGPT, Claude, Gemini 모두에서 작동
  • AI 회사가 모델 성능으로만 경쟁 (도구 락-인 못 함)
  • 사용자 win-win

OpenAI의 채택이 흥미로운 이유 — OpenAI는 보통 자기 표준 만들기 선호. Skills 채택은 "이 영역은 표준화가 우리에게도 이익" 이라는 인정. 즉 도구·도메인 지식 패키징이 차별화 영역이 아니라 인프라 영역.

이 흐름이 2026년 "Vendor-neutral AI infrastructure" 트렌드의 기둥 중 하나가 됐다.


마무리

Agent Skills는 표면적으로 "새 패키징 형식" 이지만, 실제로는 AI 산업의 표준 정의 시도다.

  • MCP의 후속작 — 도구 연결 표준 다음으로 도메인 지식 표준
  • Progressive Disclosure: 컨텍스트를 희소 자원으로 인식한 우아한 설계
  • 파일 생성 기능의 인프라: Excel/Word/PPT/PDF가 사실 Skill
  • 20+ 파트너 Skill: SaaS 생태계의 표준 인터페이스
  • 조직 단위 관리: enterprise 도입의 마지막 퍼즐
  • OpenAI도 채택: 산업 표준으로 정착

2025년 10월 16일은 "AI 도메인 지식이 portable해진 날" 이다. 2개월 후 오픈 표준화로 그 야망이 실현됐다. 이 글이 나온 시점엔 작은 announcement였지만, 6개월 후인 2026년 4월 시점에서 보면 Skills가 AI 인프라의 핵심 레이어가 됐다.

Anthropic의 일관된 패턴 — "우리가 표준을 정의한다" — 가 다시 한 번 검증됐다. MCP, sandbox-runtime, Skills — 모두 같은 전략의 다른 적용. 이 표준 베팅이 Anthropic의 enterprise 시장 점유율 40%의 진짜 동력이다.

0개의 댓글