에이전트 스킬

Agent Skills

Agent Skills는 Claude의 기능을 확장하는 모듈식 기능입니다. 각 Skill은 지침, 메타데이터 및 선택적 리소스(스크립트, 템플릿)를 패키징하며, Claude는 관련이 있을 때 자동으로 이를 사용합니다.

Skills를 사용하는 이유

Skills는 Claude에 도메인 특화 전문성을 제공하는 재사용 가능한 파일시스템 기반 리소스입니다: 워크플로우, 컨텍스트 및 모범 사례는 범용 에이전트를 전문가로 변환합니다. 프롬프트(일회성 작업을 위한 대화 수준의 지침)와 달리, Skills는 필요에 따라 로드되며 여러 대화에서 동일한 지침을 반복적으로 제공할 필요가 없습니다.

주요 이점:

Claude 전문화: 도메인 특화 작업을 위한 기능 맞춤화
반복 감소: 한 번 생성하고 자동으로 사용
기능 구성: Skills를 결합하여 복잡한 워크플로우 구축

Agent Skills의 아키텍처 및 실제 응용 프로그램에 대한 심층 분석을 위해 엔지니어링 블로그를 읽으세요: Equipping agents for the real world with Agent Skills.

Skills 사용

Anthropic은 일반적인 문서 작업(PowerPoint, Excel, Word, PDF)을 위한 사전 구축된 Agent Skills를 제공하며, 사용자 정의 Skills를 만들 수 있습니다. 둘 다 동일한 방식으로 작동합니다. Claude는 요청과 관련이 있을 때 자동으로 이를 사용합니다.

사전 구축된 Agent Skills는 claude.ai의 모든 사용자와 Claude API를 통해 사용할 수 있습니다. 전체 목록은 아래의 사용 가능한 Skills 섹션을 참조하세요.

사용자 정의 Skills를 사용하면 도메인 전문성과 조직 지식을 패키징할 수 있습니다. Claude의 모든 제품에서 사용 가능합니다: Claude Code에서 생성하거나, API를 통해 업로드하거나, claude.ai 설정에서 추가할 수 있습니다.

시작하기:

사전 구축된 Agent Skills의 경우: 빠른 시작 튜토리얼을 참조하여 API에서 PowerPoint, Excel, Word 및 PDF Skills 사용을 시작하세요
사용자 정의 Skills의 경우: 을 참조하여 자신의 Skills를 만드는 방법을 알아보세요

---
name: pdf-processing
description: Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.
---

# PDF Processing

## Quick start

Use pdfplumber to extract text from PDFs:

```python
import pdfplumber

with pdfplumber.open("document.pdf") as pdf:
    text = pdf.pages[0].extract_text()
```

For advanced form filling, see [FORMS.md](FORMS.md).

pdf-skill/
├── SKILL.md (main instructions)
├── FORMS.md (form-filling guide)
├── REFERENCE.md (detailed API reference)
└── scripts/
    └── fill_form.py (utility script)

수준	로드 시기	토큰 비용	콘텐츠
수준 1: 메타데이터	항상 (시작 시)	Skill당 약 100 토큰	YAML 프론트매터의 `name` 및 `description`
수준 2: 지침	Skill이 트리거될 때	5k 토큰 미만	지침 및 지침이 포함된 SKILL.md 본문
수준 3+: 리소스	필요에 따라	사실상 무제한	bash를 통해 실행되는 번들 파일로 컨텍스트에 로드되지 않음

---
name: your-skill-name
description: Brief description of what this Skill does and when to use it
---

# Your Skill Name

## Instructions
[Clear, step-by-step guidance for Claude to follow]

## Examples
[Concrete examples of using this Skill]

Agent Skills

Skills를 사용하는 이유

Skills 사용

Agent Skills

Skills를 사용하는 이유

Skills 사용

Skills 작동 방식

세 가지 유형의 Skill 콘텐츠, 세 가지 로딩 수준

수준 1: 메타데이터 (항상 로드됨)

수준 2: 지침 (트리거될 때 로드됨)

수준 3: 리소스 및 코드 (필요에 따라 로드됨)

Skills 아키텍처

예제: PDF 처리 Skill 로드

Skills가 작동하는 위치

Claude API

Claude Code

Claude Agent SDK

Claude.ai

Skill 구조

보안 고려 사항

사용 가능한 Skills

사전 구축된 Agent Skills

사용자 정의 Skills 예제

제한 사항 및 제약

교차 표면 가용성

공유 범위

런타임 환경 제약

다음 단계