스킬

스킬은 에이전트에 도메인별 전문 지식을 제공하는 재사용 가능한 파일 시스템 기반 리소스입니다. 워크플로우, 컨텍스트, 모범 사례를 통해 범용 에이전트를 전문가로 전환합니다. 일회성 작업을 위한 대화 수준 지침인 프롬프트와 달리, 스킬은 필요할 때만 로드되어 필요한 경우에만 "context window"(컨텍스트 윈도우)에 영향을 미칩니다.

두 가지 유형의 스킬을 연결할 수 있습니다. 두 유형 모두 동일한 방식으로 작동하며, 에이전트는 작업과 관련이 있을 때 자동으로 스킬을 호출합니다.

• 사전 구축된 Anthropic 스킬: PowerPoint, Excel, Word, PDF 처리와 같은 일반적인 문서 작업(pptx, xlsx, docx, pdf).
• 커스텀 스킬: 직접 작성하여 워크스페이스에 업로드하는 스킬.

커스텀 스킬을 작성하는 방법은 Agent Skills 및 스킬 작성 모범 사례를 참조하세요. 워크스페이스에 커스텀 스킬을 업로드하려면 커스텀 스킬 생성을 참조하세요.



커스텀 스킬 생성

커스텀 스킬은 SKILL.md 파일과 지원 파일을 포함하는 디렉터리로, zip 아카이브 또는 개별 파일로 워크스페이스에 업로드됩니다. 스킬을 생성하면 에이전트에 연결할 때 참조하는 skill_* ID가 반환됩니다. Anthropic 사전 구축 스킬은 모든 워크스페이스에서 이미 사용 가능하므로 이 단계가 필요하지 않습니다. 사전 구축 스킬만 사용하려면 에이전트에 스킬 연결로 건너뛰세요.

cURL 또는 CLI로 Skills API를 직접 호출할 때는 anthropic-beta: skills-2025-10-02 헤더를 명시적으로 전달하세요. SDK는 이를 자동으로 전송합니다.

이 예제들은 선택적 display_title 필드를 생략하므로 스킬의 제목은 SKILL.md에서 파생됩니다. 명시적으로 전달된 display_title은 워크스페이스의 커스텀 스킬 중에서 고유해야 합니다.

ant beta:skills create \
  --file example_skill.zip \
  --beta skills-2025-10-02

커스텀 스킬을 나열, 조회, 삭제 및 버전 관리하려면 커스텀 스킬 관리를 참조하세요. 전체 요청 및 응답 스키마는 Create Skill API 레퍼런스를 참조하세요. 스킬 번들은 Files API를 통하지 않고 Skills API에 직접 업로드됩니다.



에이전트에 스킬 연결

에이전트를 생성할 때 스킬을 연결하세요. 각 세션은 세션 내 모든 에이전트를 합산하여 최대 20개의 스킬을 지원합니다(멀티 에이전트 세션 참조).

skills 배열의 각 항목은 다음 필드를 사용합니다.

ant beta:agents create <<'YAML'
name: Financial Analyst
model: claude-opus-4-8
system: You are a financial analysis agent.
skills:
  - type: anthropic
    skill_id: xlsx
  - type: custom
    skill_id: skill_abc123
    version: latest
YAML



다음 단계