엔트로픽에서 공개한 더 똑똑한 AI를 만드는 기술, Agent Skills을 소개합니다.

안녕하세요,

최근 인공지능이 다양한 산업과 업무 전반에 빠르게 도입되면서, 많은 사람들이 AI의 도움을 받아 일상적인 업무를 효율적으로 처리하고 있습니다. 그러나 아무리 강력한 모델이라도 정확하지 않은 답변을 제시한다면, 그 활용도는 크게 제한될 수밖에 없습니다. 결국 AI 시대의 핵심은 신뢰성 있는 결과를 어떻게 보장하느냐에 달려 있습니다.

이러한 문제를 해결하기 위해 엔트로픽(Anthropic)은 새로운 개념인 Agent Skills를 공개했습니다. 이 기능은 AI 모델이 단순히 텍스트를 생성하는 수준을 넘어, 특정 작업에 필요한 정확한 지식과 도구를 스스로 선택해 활용하도록 설계된 기술입니다.

이번 포스팅에서는 Agent Skills의 개념과 구조, 그리고 실제로 어떻게 AI의 신뢰성과 정확도를 향상시키는지에 대해 자세히 살펴보겠습니다.

---

반응형

Agent Skills

2025년 10월 17일, 엔트로픽에서 "Agent Skills"라는 새로운 내용을 공개했습니다. 이 Skills는 Claude(AI 모델)가 특정 작업을 보다 정교하고 전문적으로 수행할 수 있도록 엔트로픽이 개발한 기능 구성 단위입니다. 스킬은 다음과 같은 요소들을 포함할 수 있습니다. 즉, Skills는 Claude가 특정한 맥락이나 업무 흐름(workflow)에 맞춰 스스로 적절한 전문 지식이나 도구를 불러 쓰게끔 설계된 패키지입니다. 스킬은 필요한 시점에만 불러져 동작하도록 되어 있어, 작업 효율과 속도 그리고 정확도를 높이도록 설계되어 있습니다.

 

• 엔트로픽 공식페이지 : https://www.anthropic.com/news/skills

Claude Skills: Customize AI for your workflows

 

스킬을 사용하는 Claude 모델은 단순히 입력된 프롬프트에 즉시 답변을 생성하는 구조가 아니라, 사용자의 의도를 분석하고 그에 적합한 스킬을 선택·실행하여 최적의 결과를 도출하는 방식으로 작동합니다.

프롬프트 입력 → 스킬 선택 → 스킬 로드 → 가이드된 추론 → 실행 및 응답

 

이 전체 흐름에서 핵심 제어 역할은 Skill Engine이 담당하며, Claude 모델은 사용자의 의도를 추론하고, 그 결과에 따라 적절한 스킬을 선택하고 로드하는 판단자 역할을 수행합니다.

┌───────────────────────────────────────┐
│ User Prompt                           │
└───────────────┬───────────────────────┘
                │
                ▼
        [1] 의도 분석
        └─ Claude가 요청 분석
                │
                ▼
        [2] 스킬 선택
        └─ 어떤 스킬을 사용할지 추론
                │
                ▼
        [3] 스킬 로드
        └─ Skill Engine이 스킬 로드·실행
                │
                ▼
        [4] 가이드 추론
        └─ 스킬 지침 기반으로 Claude 재추론
                │
                ▼
        [5] 응답
        └─ 사용자에게 결과 반환

 

[전체 구조 요약]

단계	담당	역할
입력 분석	Claude LLM	사용자의 의도 파악
스킬 선택	Claude LLM	어떤 스킬을 쓸지 추론
스킬 로드	Skill Engine	스킬 메타데이터 해석 및 실행
가이드된 추론	Claude LLM	스킬의 지침을 따라 추론 방향 조정
결과 출력	Claude LLM	결과를 자연어로 포맷팅 후 반환

 

 

주요 특징

스킬 기능이 지닌 주요 특징을 요약하면 다음과 같습니다.

• 조합 가능(Composable): 여러 스킬이 동시에 혹은 순차적으로 연동될 수 있도록 설계되어 있으며, Claude가 어떤 작업에 어떤 스킬이 필요한지 자동으로 판단하여 사용합니다.
• 휴대 가능(Portable): 동일한 스킬 형식을 여러 Claude 제품(앱, 코드 환경, API 등)에서 동일하게 사용할 수 있도록 만들어져 있습니다.
• 효율적(Efficient): Claude가 스킬 전체를 불러오는 대신 “해당 작업에 필요한 최소한의 정보와 파일만” 로딩함으로써 속도와 리소스 측면에서 이점을 가집니다.
• 강력(Powerful): 스킬은 단순히 프롬프트를 통해 텍스트를 생성하는 것을 넘어, 코드 실행(code execution) 형태로 작업을 할 수 있도록 설계되어 있습니다. 예컨대, 스프레드시트 작업, 프레젠테이션 생성 등 “전통적 프로그래밍 방식이 더 신뢰할 만한 영역”에서도 활용됩니다.

 

 

Skill 구성

Claude의 하나의 스킬은 보통 다음 세 부분으로 이루어집니다.

구성 요소	설명	형식
① 메타데이터 파일	스킬의 이름, 설명, 권한, 실행 진입점(entry point) 등을 정의	.yaml
② 실행 코드	실제로 작업을 수행하는 함수나 코드 로직 (모델 호출, 데이터 처리 등)	.py
③ 지침(Instruction)	Claude가 추론할 때 참고해야 하는 가이드라인이나 출력 형식	텍스트 혹은 YAML 내 포함

 

 

사용 예시

엔트로픽에서 공개한 Skill은 Claude의 다양한 활용 가능성을 보여주는 예시로, 실제 적용 가능한 시나리오는 다음과 같습니다.

• 코드 리뷰(code-reviewer) : 코드의 구조, 보안, 성능을 분석하고 개선 방향을 제시합니다.
• 디자인 생성(canvas-design) : 입력된 프롬프트를 기반으로 .png 또는 .pdf 형식의 시각 자료를 생성합니다.
• 웹 테스트(webapp-testing) : Playwright를 이용해 웹 애플리케이션의 UI 동작을 자동으로 검증합니다.
• MCP 서버 구축(mcp-server) : 외부 API와 연동되는 MCP 서버를 구성하고 테스트 과정을 자동화합니다.
• 브랜드 관리(brand-guideline) : 기업의 색상, 로고, 서체 규칙을 문서나 콘텐츠에 일관되게 적용합니다.

엔트로픽의 공식 깃허브에서는  개발자가 이러한 시나리오를 직접 응용할 수 있도록 다양한 예시용 스킬을 공개하고 있습니다.

 

---

간단한 사용 예시

현재 Skills는 Claude 유료 멤버쉽 또는 Claude Code, API, SDK를 통해 사용해볼 수 있습니다. 이번 포스팅에서는 API 방법을 통해 간단히 테스트를 진행해 보겠습니다.

 

1. Claude API 키 발급

Claude API 키는 Claude Console에서 발급할 수 있습니다.

• Claude Console : https://console.anthropic.com/settings/keys

출처: Claude Console

 

2. 코드 작성

이 코드는 엔트로픽의 Claude Sonnet 4.5 모델을 활용하여 엑셀 파일을 자동 생성하도록 요청한 예시입니다. 실행 시 Claude는 내부적으로 xlsx 스킬과 code_execution 도구를 사용하여 실제 엑셀 파일을 생성하고, 그 결과를 Base64 형태의 텍스트 데이터로 반환하여 그 결과값을 출력합니다.

# Python
import anthropic

# 클라이언트 초기화
client = anthropic.Anthropic(api_key="YOUR API KEY")  # 사용자 API 키로 수정

# 메시지 생성 (Skill 및 코드 실행 기능 포함)
response = client.beta.messages.create(
    #model="claude-haiku-4-5-20251001",  # Claude Haiku 4.5 모델
    model="claude-sonnet-4-5-20250929",  # Claude sonnet 4.5 모델
    max_tokens=1024,
    betas=["code-execution-2025-08-25", "skills-2025-10-02"],
    container={
        "skills": [  # Skills 정의
            {"type": "anthropic", "skill_id": "xlsx", "version": "latest"}
        ]
    },
    messages=[
        {
            "role": "user",
            "content": (
                "Create an Excel (.xlsx) file with two columns: 'Model' and 'Accuracy'. "
                "Include sample AI model performance data. "
                "Return ONLY the Base64-encoded file content, without any explanation or text."
            )
        }
    ],
    tools=[
        {"type": "code_execution_20250825", "name": "code_execution"}
    ]
)

print(response.content)

3. 실행 결과

코드를 실행하면 로그에 "/skills/xlsx/SKILL.md" 경로가 표시됩니다. 이 경로는 Claude가 “xlsx” 스킬을 불러와 실제 작업에 활용하고 있음을 나타냅니다. 즉, 단순히 텍스트를 생성하는 것이 아니라, 엔트로픽(Anthropic)에서 공식적으로 제공하는 엑셀 처리용 스킬(xlsx skill) 을 호출하여 엑셀 파일을 생성하고, 서식을 지정하며, 데이터를 입력하는 일련의 과정을 자동으로 수행한 것입니다.

로그를 살펴보면 모델이 "xlsx" 스킬을 요청하고 이를 로드한 뒤, 사용자가 입력한 프롬프트에 따라 ‘Model’과 ‘Accuracy’ 두 개의 열을 가진 엑셀 데이터를 생성하는 과정을 확인할 수 있습니다. 즉, Claude가 사용자의 명령을 해석하여 필요한 스킬을 선택하고, 해당 스킬의 가이드라인에 따라 AI 모델 성능 데이터가 포함된 엑셀 파일을 완성한 것입니다.

실제로 생성된 엑셀 파일 또한 확인할 수 있습니다.

실행 결과

 

이와 같은 스킬은 Claude Console에서 직접 추가하거나 제거할 수 있습니다. 또한 엔트로픽의 공식 GitHub 저장소에서는 이러한 스킬을 직접 커스터마이징하는 방법을 안내하고 있습니다. 개발자는 제공된 템플릿을 활용해 자신만의 스킬을 작성한 뒤, 이를 Claude Console에 등록함으로써 특정 업무나 도메인에 최적화된 맞춤형 Claude 환경을 구성할 수 있습니다.

 

• 엔트로픽 깃허브 : https://github.com/anthropics/skills
• Claude Console (Skill) : https://console.anthropic.com/workspaces/default/skills

 

---

 

초기의 인공지능은 종종 환각 현상으로 인해 부정확한 정보를 생성하곤 했습니다. 이로 인해 AI가 제시하는 답변의 신뢰성이 떨어지고, 실제 활용에서도 한계가 존재했습니다. 그러나 최근에는 Skill과 같은 모듈형 기능이 도입되면서, AI가 단순한 언어 모델을 넘어 정확한 맥락 이해와 외부 도구 활용을 결합하는 방향으로 발전하고 있습니다. 이러한 기술들은 모델이 스스로 필요한 도구를 선택하고, 데이터를 분석하며, 보다 정밀하고 근거 있는 답변을 생성할 수 있도록 돕는 핵심 요소로 자리 잡고 있습니다.

 

앞으로는 이와 같은 Skill 기반의 구조적 접근이 확산되면서, AI가 환각 없이 신뢰할 수 있는 정보를 제공하는 방향으로 더욱 발전할 것으로 예상됩니다.

 

감사합니다. 😊