Anthropic Agent Skills: 점진적 로딩으로 기업 도메인 지식을 에이전트에 심는 법

Anthropic이 2026년 2월, 기업용 에이전트 생태계를 재편할 대형 발표를 단행했다. Claude.ai, Claude Code, Claude Agent SDK, API 전 서피스에 걸쳐 동작하는 'Agent Skills' 시스템이 Pro·Max·Team·Enterprise 플랜에 추가 비용 없이 열렸고, 인사·디자인·엔지니어링·금융·법률 등 주요 도메인별 프리빌트 플러그인 템플릿이 함께 공개됐다. Anthropic은 이와 동시에 Agent Skills 사양과 레퍼런스 SDK를 독립 오픈 스탠다드로 공개해, 특정 AI 공급사에 종속되지 않는 범용 에이전트 플러그인 생태계를 구축하겠다는 의지를 밝혔다.

매 대화마다 반복 주입하던 컨텍스트를 한 번만

Agent Skills는 Claude에게 도메인 특화 전문 역량을 주입하는 모듈형 확장 단위다. 각 스킬은 SKILL.md 명세 파일, 실행 가능한 스크립트, 참조 자료 등으로 구성된 디렉터리로 패키징되며, 새 팀원을 위한 온보딩 가이드처럼 Claude가 필요한 시점에 동적으로 불러온다. 기존 프롬프트 방식이 매 대화마다 동일한 맥락을 반복 주입해야 했던 것과 달리, Skills는 온디맨드로 로드되어 컨텍스트 낭비를 최소화하고 한번 정의해 두면 Claude.ai 채팅, Claude Code 터미널, API 호출 어디서든 동일하게 재사용할 수 있다.

기존 방식의 한계	Agent Skills의 해법
매 대화마다 동일 컨텍스트 반복 주입	스킬을 한 번 등록 후 자동 트리거
긴 시스템 프롬프트로 인한 토큰 낭비	3단계 점진적 로딩으로 필요한 내용만 소비
플랫폼별 설정 파편화	전 서피스 동일 스킬 사용 (API·claude.ai·Claude Code)
반복 작업에 일관성 부족	스크립트 기반 결정론적 실행으로 재현성 보장

필요한 만큼만 단계별로 읽는다

Agent Skills의 핵심 설계 원칙은 점진적 공개(Progressive Disclosure)다. 스킬 콘텐츠를 세 수준으로 나누어 실제 필요할 때만 컨텍스트 창에 올린다.

⤢✕

레벨 1인 메타데이터는 SKILL.md의 YAML 프론트매터(name, description)만 읽는다. 스킬이 수십 개 설치되어 있어도 각각 약 100토큰만 소비하므로 전체 비용이 미미하다. 레벨 2인 지침은 요청이 스킬 설명과 매칭되면 SKILL.md 본문 전체를 로드하는 단계로, 절차·워크플로우·베스트 프랙티스가 담긴 5,000토큰 이하의 핵심 지침이다. 레벨 3인 리소스와 코드는 추가 마크다운 가이드, 실행 스크립트(validate_form.py 등), 데이터베이스 스키마 같은 참조 자료를 필요할 때만 읽는다. 스크립트를 실행할 경우 코드 자체는 컨텍스트에 올라오지 않고 출력 결과만 주입되므로 토큰 효율이 극대화된다.

문서 처리부터 도메인 부서 업무까지

Anthropic이 런칭과 함께 공개한 프리빌트 스킬은 두 계층으로 나뉜다. Anthropic 공식 내장 스킬은 API와 Claude.ai에서 즉시 쓸 수 있는 네 가지 문서 처리 스킬로, skill_id로 참조하면 별도 설정 없이 동작한다.

스킬 이름	skill_id	주요 기능
PowerPoint	`pptx`	프레젠테이션 생성·편집·분석
Excel	`xlsx`	스프레드시트 작성, 데이터 분석, 차트 리포트
Word	`docx`	문서 생성·편집·서식 적용
PDF	`pdf`	PDF 생성, 텍스트·테이블 추출, 폼 처리

엔터프라이즈 도메인 플러그인 템플릿은 각 부서의 반복 업무를 캡슐화한다.

⤢✕

각 플러그인은 해당 업종에서 공통적으로 필요한 기본 스킬을 포함하면서도, 조직 고유의 브랜드 톤·내부 프로세스·용어 체계에 맞게 커스터마이징할 수 있도록 설계되어 있다.

API로 스킬을 등록하고 호출하는 절차

Skills API는 RESTful 인터페이스로 스킬의 생성·조회·버전 관리·삭제를 지원한다.

POST   /v1/skills                              # 스킬 생성
GET    /v1/skills                              # 스킬 목록 조회
GET    /v1/skills/{skill_id}                   # 스킬 상세 조회
DELETE /v1/skills/{skill_id}                   # 스킬 삭제

POST   /v1/skills/{skill_id}/versions          # 새 버전 생성
GET    /v1/skills/{skill_id}/versions          # 버전 목록 조회
DELETE /v1/skills/{skill_id}/versions/{ver}    # 특정 버전 삭제

Skills를 API로 쓰려면 세 개의 베타 헤더를 함께 보내야 한다.

anthropic-beta: code-execution-2025-08-25,skills-2025-10-02,files-api-2025-04-14

code-execution-2025-08-25는 코드 실행 컨테이너 활성화(Skills 동작의 전제 조건)이고, skills-2025-10-02는 Skills API 기능 활성화, files-api-2025-04-14는 컨테이너 내 파일 업로드·다운로드를 담당한다.

curl -X POST "https://api.anthropic.com/v1/skills" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: skills-2025-10-02" \
  -F "display_title=Financial Analysis" \
  -F "files[]=@financial_skill/SKILL.md;filename=financial_skill/SKILL.md" \
  -F "files[]=@financial_skill/analyze.py;filename=financial_skill/analyze.py"

응답으로 받은 skill_id는 이후 메시지 요청의 container.skills 배열에서 참조한다.

{
  "model": "claude-opus-4-7",
  "max_tokens": 4096,
  "container": {
    "skills": [
      { "type": "anthropic", "skill_id": "xlsx", "version": "latest" },
      { "type": "custom",    "skill_id": "skill_01AbCd...", "version": "latest" }
    ]
  },
  "messages": [{ "role": "user", "content": "분기별 매출 데이터를 분석하고 시각화해줘" }],
  "tools": [{ "type": "code_execution_20250825", "name": "code_execution" }]
}

요청 당 최대 8개의 스킬을 조합할 수 있으며, container.id를 재사용하면 멀티턴 대화 전반에 걸쳐 동일한 컨테이너 상태를 유지할 수 있다.

버전 관리와 접근 통제가 필요한 이유

Skills API는 날짜 기반(20251013) 및 에포크 타임스탬프(1759178010641129) 방식으로 버전을 식별한다. latest를 지정하면 최신 버전이 자동 선택되고, 특정 버전을 고정하면 프로덕션 환경에서의 예측 가능성이 확보된다.

⤢✕

접근 제어에서는 API를 통해 업로드된 커스텀 스킬이 해당 API 워크스페이스 전체에서 공유되고 타 조직 워크스페이스는 접근할 수 없는 워크스페이스 격리, Claude.ai에서는 개인 사용자 단위·API에서는 워크스페이스 단위·Claude Code에서는 프로젝트 또는 사용자 홈 디렉터리(~/.claude/skills/) 단위로 격리되는 플랫폼별 범위, Skills 정의와 실행 데이터가 Zero Data Retention 대상이 아니므로 고도의 기밀 데이터를 다루는 환경에서 사전 고려가 필요한 ZDR 비적용이 원칙이다.

Anthropic은 스킬을 소프트웨어 설치와 동등한 수준의 신뢰 판단이 필요한 작업으로 규정한다. SKILL.md·스크립트·이미지 등 번들된 모든 파일을 빠짐없이 검토하고, 예상치 못한 네트워크 호출·비정상적인 파일 접근 패턴·스킬의 명시 목적과 무관한 작업을 탐지하며, 외부 URL에서 데이터를 패치하는 스킬은 종속성 변경 시 악의적 콘텐츠 주입 위험이 있으므로 특별히 주의하고, 민감 데이터에 접근하는 프로덕션 환경에서는 신뢰 출처(직접 작성 또는 Anthropic 공식 배포) 스킬만 쓰는 것이 보안 감사 체크리스트다.

데이터를 가져오는 MCP, 그 데이터를 다루는 Skills

서피스마다 네트워크 접근과 공유 범위 특성이 다르다.

⤢✕

엔터프라이즈 런칭과 함께 공개된 새 커넥터(Gmail, DocuSign, Clay 등)는 MCP(Model Context Protocol) 기반으로 외부 데이터를 에이전트에 직접 공급한다. Skills와 MCP 커넥터는 상호 보완적인 역할을 맡는다 — MCP 커넥터는 외부 시스템의 실시간 데이터와 인증된 액션을 Claude에 연결하는 데이터 파이프이고, Agent Skills는 그 데이터를 가져와 어떻게 분석·변환·문서화할지에 관한 도메인 전문성을 캡슐화한 지식 레이어다. 예컨대 법률 부서 시나리오에서 DocuSign MCP 커넥터가 계약서 원본을 가져오면 법률 도메인 스킬이 조직 고유의 검토 체크리스트와 컴플라이언스 기준을 적용해 분석 보고서를 생성한다. 두 레이어를 분리한 덕분에 커넥터나 스킬 어느 한쪽만 교체해도 나머지 레이어에는 영향이 없다.

락인을 피하려는 오픈 스탠다드 전략

Anthropic이 agentskills.io를 통해 공개한 오픈 스탠다드는 Agent Skills를 Claude 전용 기능이 아닌 멀티 AI 플랫폼 호환 규격으로 확장하려는 전략적 선택이다. 첫째는 락인 방지로, 기업이 특정 AI 공급사에 종속되지 않고 한 번 작성한 스킬을 다양한 AI 런타임에서 재사용할 수 있다. 둘째는 생태계 확장으로, 서드파티 도구 개발사와 컨설팅 파트너가 검증된 산업별 스킬 패키지를 마켓플레이스에 등록·배포할 수 있는 기반이 마련된다. 셋째는 표준화된 인터페이스로, SKILL.md의 YAML 프론트매터 명세(name, description, 최대 64자/1024자 제약 등)가 스킬 디스커버리의 공통 언어가 된다.

---
name: financial-analysis          # 소문자·숫자·하이픈, 최대 64자
description: |
  분기 재무 데이터를 분석하고 시각화 보고서를 생성한다.
  Excel, CSV 파일 처리 또는 재무 KPI 대시보드 요청 시 사용.
---

# Financial Analysis Skill

## 빠른 시작

## 워크플로우

## 예시

description 필드는 단순 설명이 아니라 Claude가 이 스킬을 언제 트리거할지 판단하는 의도 신호다. "무엇을 하는가"와 "어떤 상황에서 사용하는가"를 모두 담아야 효과적인 자동 트리거가 이루어진다.

플랜	내장 스킬 (pptx·xlsx 등)	커스텀 스킬	API 스킬 업로드	조직 전체 공유
Free	제한적	미지원	미지원	미지원
Pro	지원	지원	미지원	미지원 (개인)
Max	지원	지원	미지원	미지원 (개인)
Team	지원	지원	지원	워크스페이스 공유
Enterprise	지원	지원	지원	중앙화 관리

Pro·Max·Team·Enterprise 플랜 사용자는 모두 추가 비용 없이 Skills 기능을 쓸 수 있다. API를 통한 사용은 표준 API 요금이 적용된다.

Anthropic의 Agent Skills는 단순한 플러그인 시스템을 넘어, 기업이 조직 지식을 재사용 가능한 에이전트 역량으로 체계화하는 새로운 패러다임을 제시한다. 점진적 로딩 아키텍처와 버전 관리, 서피스 전반을 아우르는 일관된 인터페이스는 대규모 조직에서 AI 에이전트를 안정적으로 운영하기 위한 핵심 기반이 된다. 오픈 스탠다드 전략을 통해 생태계 주도권을 확보하려는 Anthropic의 행보는, 기업용 AI 인프라의 표준 경쟁이 모델 성능만이 아니라 플러그인 호환성과 거버넌스 체계로도 이동하고 있음을 시사한다.