Claude Agent Skills: AI를 나만의 전문가로 만드는 방법

2025년 10월 16일, Anthropic이 Claude AI에 Agent Skills 기능을 추가했습니다. AI 에이전트에게 특정 업무를 전문적으로 수행할 수 있는 능력을 부여하는 기능으로, Claude를 맞춤형 전문 비서처럼 활용할 수 있게 해 줍니다.

Equipping agents for the real world with Agent Skills

---

Agent Skills란?

Agent Skills는 Claude에 필요한 기능을 추가할 수 있는 확장 패키지입니다. 지시 사항, 메타데이터, 스크립트, 리소스를 패키지로 묶어서 Claude가 특정 작업을 자동으로 수행할 수 있게 합니다. 쉽게 말하면, Claude에게 특정 업무를 잘하도록 알려주는 교육 자료나 매뉴얼입니다.

회사로 비유하자면..

기존 Claude는 신입 사원과 비슷합니다. 매번 같은 지시를 반복해야 하고, "어떤 형식으로 만들어 드릴까요?", "어떤 섹션이 필요한가요?" 같은 질문을 계속 받습니다. 새 대화를 시작할 때마다 처음부터 설명해야 하죠.

Skills를 장착한 Claude는 숙련된 직원에 가깝습니다. 회사의 업무 프로세스와 규정을 이미 파악하고 있어서, 간단한 지시만으로도 정확하고 일관된 결과물을 만들어냅니다. 한번 가르쳐 주면 계속 기억해서 꺼내 쓸 수 있습니다.

Agent Skills의 세 가지 핵심 장점

• 첫째, Claude를 전문화할 수 있습니다. 도메인별 특화된 역량을 부여해서 전문가처럼 활용할 수 있고, 브랜드 가이드라인이나 특정 프로젝트에 맞게 대응할 수 있습니다.
• 둘째, 반복 작업을 줄입니다. 한 번 만들어두면 계속 활용할 수 있어서, "A 스킬로 이걸 해줘", "B 스킬로 저걸 해줘"처럼 간단하게 요청할 수 있습니다.
• 셋째, 여러 스킬을 조합할 수 있습니다. 데이터 분석, 보고서 작성, 시각화 스킬을 동시에 사용해서 복잡한 워크플로우를 구축할 수 있습니다.

Skills의 작동 원리: 점진적 공개 방식

Agent Skills는 점진적 공개(Progressive Disclosure) 방식으로 세 단계에 걸쳐 작동합니다.

• 1단계 - 인식(Discovery): Claude가 시작할 때 모든 스킬의 이름과 설명만 로드합니다. 게임에서 스킬 창에 어떤 스킬이 있는지 아는 것과 비슷합니다. 파이어볼, 아이스볼이 있다는 건 알지만 아직 사용하지 않은 상태입니다.
• 2단계 - 활성화(Activation): 사용자의 요청이 특정 스킬과 관련되면 해당 스킬이 발동됩니다. "매출 데이터를 PPT로 만들어줘"라고 요청하면 PPT 스킬이 자동으로 활성화됩니다.
• 3단계 - 실행(Execution): 스킬의 상세 지침과 리소스를 불러와 실제 작업을 수행합니다. PPT 구성 방법, 적용할 디자인, 데이터 시각화 방식 등 모든 정보가 이 단계에서 적용됩니다.

이 방식 덕분에 토큰 사용량이 효율적이고, 필요한 순간에만 관련 컨텍스트를 불러오므로 빠르고 정확하게 작동합니다.

Skills vs MCP vs 커스텀 인스트럭션

세 가지 기능의 차이는 다음과 같습니다.

• Skills는 특정 작업에 특화된 전문성입니다. PPT 작성, 데이터 분석, 보고서 생성 등 명확한 업무를 자동화하는 데 적합합니다. 관련 작업 시 자동으로 발동되며, 토큰 효율성이 높습니다.
• MCP(Model Context Protocol)는 외부 시스템과의 연결입니다. 노션, Gmail, Google Drive 등 외부 도구와 연동해서 데이터를 가져오거나 작업을 수행합니다. 외부 도구 호출 시에만 명시적으로 사용됩니다.
• 커스텀 인스트럭션은 모든 대화에 적용되는 전체 공통 설정입니다. "항상 한국어로 답변해 줘", "간결하게 답변해줘" 같은 패시브 스킬이라고 보면 됩니다.

세 가지를 함께 사용하면 시너지가 납니다. MCP로 외부 데이터를 가져오고, Skills로 해당 데이터를 처리하고, 커스텀 인스트럭션으로 일관된 스타일을 유지하는 워크플로우를 구축할 수 있습니다.

스킬의 종류

내장 스킬 (Anthropic Skills)

별도 설정 없이 바로 사용할 수 있는 기본 제공 기능입니다. 엑셀(xlsx), 워드(docx), 파워포인트(pptx), PDF 처리 스킬이 포함되어 있어 문서 작업을 바로 시작할 수 있습니다.

커스텀 스킬 (Custom Skills)

사용자가 직접 만드는 맞춤형 스킬입니다. 회사의 보고서 양식, 브랜드 가이드라인, 특정 분석 프로세스 등을 스킬로 만들어 반복적으로 활용할 수 있습니다.

---

스킬 활성화 방법

Agent Skills는 Claude Pro 이상 유료 구독자가 사용할 수 있습니다. 활성화 순서는 다음과 같습니다.

1. Claude.ai에 로그인합니다
2. 왼쪽 아래의 사용자 이름을 클릭하고 설정으로 들어갑니다
3. 기능(Features) 탭에서 Code Execution and File Creation을 활성화합니다
4. 아래에 각종 스킬들이 나타납니다

스킬 크리에이터(Skill Creator)를 켜두면 대화를 통해 새로운 스킬을 만들 수 있습니다.

스킬의 기본 구조

스킬은 폴더 형태로 구성되며, 핵심은 SKILL.md 파일입니다.

my-skill/
├── SKILL.md          # 필수: 지침 + 메타데이터
├── scripts/          # 선택: 실행 가능한 코드
├── references/       # 선택: 참조 문서
└── assets/           # 선택: 템플릿, 리소스

SKILL.md 파일은 YAML 프론트매터와 마크다운 본문으로 구성됩니다.

---
name: monthly-sales-report
description: 월간 매출 데이터를 분석하고 보고서를 생성합니다.
---

# 월간 매출 보고서 생성기

## 이 스킬을 사용할 때
사용자가 매출 데이터 분석이나 보고서 작성을 요청할 때...

## 작업 순서
1. 데이터 파일 확인
2. 주요 지표 분석
3. 차트 생성
4. 보고서 작성

name은 스킬 이름으로 최대 64자까지 가능하며, 영문 소문자와 하이픈만 사용할 수 있습니다. description은 스킬을 언제 사용할지에 대한 설명으로, Claude가 이 설명을 보고 적절한 상황에서 스킬을 발동시킵니다.

---

커스텀 스킬 만드는 두 가지 방법

방법 1: 대화로 스킬 만들기 (초보자 추천)

스킬 크리에이터를 활성화한 후, Claude에게 직접 요청하면 됩니다. "우리 회사 브랜드 가이드라인 스킬을 만들고 싶어. 도와줘"라고 하면, Claude가 필요한 정보를 물어보고 스킬을 자동으로 생성합니다.

브랜드 색상, 톤 앤 매너, 주요 용어 등을 대화로 정의하면, Claude가 이를 바탕으로 스킬 파일을 만들어줍니다. 코딩 지식이 없어도 충분히 만들 수 있습니다.

방법 2: 직접 작성하여 업로드하기

SKILL.md 파일을 직접 작성하고, zip으로 압축한 후 업로드합니다. 설정의 기능 탭에서 스킬 업로드 버튼을 클릭하고 압축 파일을 드래그하면 됩니다.

직접 작성이 어렵다면, 한글로 스킬 내용을 정리한 후 Claude에게 "이 내용을 스킬 양식에 맞게 작성해 줘"라고 요청하면 적절한 형식으로 변환해 줍니다.

---

활용 사례

PPT 자동 생성

매출 데이터 파일을 업로드하고 "이 데이터로 월간 매출 보고서 PPT를 만들어줘"라고 요청하면, Claude가 PPT 스킬을 자동으로 발동시켜 프레젠테이션을 생성합니다. 다운로드 가능한 PPTX 파일로 제공되어 바로 파워포인트에서 열 수 있습니다.

브랜드 가이드라인 적용

회사의 브랜드 색상, 폰트, 톤 앤 매너를 스킬로 정의해 두면, 이후 모든 콘텐츠 제작에 일관된 브랜드 아이덴티티가 적용됩니다. "인스타그램 카드뉴스 만들어줘"라고만 해도 브랜드 가이드라인에 맞는 디자인이 나옵니다.

정기 보고서 자동화

매주 또는 매월 작성하는 정형화된 보고서가 있다면, 해당 양식을 스킬로 만들어두세요. 데이터만 제공하면 동일한 형식의 보고서가 자동으로 생성됩니다.

---

Claude Code에서의 활용

개발자라면 Claude Code에서 Skills를 더 강력하게 활용할 수 있습니다. .claude/skills/ 폴더에 스킬을 정의하면, 해당 프로젝트에서 자동으로 인식됩니다.

보안 주의사항

Skills를 사용할 때 몇 가지 보안 사항을 염두에 두어야 합니다.

• 신뢰할 수 있는 소스의 스킬만 사용하세요
• 외부에서 가져온 스킬은 코드 내용을 반드시 검토해야 합니다
• 외부 네트워크 연결이 포함되어 있는지 확인하세요
• API 키나 비밀번호 같은 민감한 정보는 스킬에 포함시키지 마세요

---

성공적인 스킬 작성을 위한 팁

• 작게 시작하세요. 처음부터 복잡한 스킬을 만들기보다, 간단한 스킬부터 만들어보면서 감을 익히는 게 좋습니다.
• 명확한 목적을 가지세요. 하나의 스킬에는 하나의 명확한 목적만 담아야 합니다. 여러 기능을 하나의 스킬에 넣으면 오히려 정확도가 떨어집니다.
• 지속적으로 개선하세요. 스킬을 사용하면서 부족한 부분이 발견되면 계속 업데이트하세요. 스킬 파일은 버전 관리가 가능하므로 팀과 공유하며 함께 발전시킬 수 있습니다.

---

참고

• https://agentskills.io - Agent Skills 공식 문서 사이트 (스펙, 통합 가이드, 베스트 프랙티스 등)
• https://github.com/anthropics/skills - Anthropic의 공식 예제 스킬 저장소
• https://github.com/agentskills/agentskills - skills-ref 레퍼런스 라이브러리 (스킬 검증, 프롬프트 XML 생성 도구)
• https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview - Claude 공식 문서 (Skills 섹션 포함)