Agent Skills with Anthropic
스킬 시스템으로 AI 에이전트를 전문가로 만드는 방법
DeepLearning.AI × Anthropic | 강사: Elie Schoppik | 2시간 19분 | 무료
📑 목차
1. 강좌 소개 및 개요
인공지능 에이전트의 시대가 본격적으로 열리면서, 단순히 대화만 하는 챗봇을 넘어 실제 작업을 수행하는 에이전트에 대한 관심이 폭발적으로 증가하고 있습니다. 그런데 범용 에이전트에게 특정 도메인의 전문 작업을 맡기면, 매번 같은 지침을 반복해서 입력해야 하는 문제가 발생합니다. 예를 들어 "엑셀 보고서를 만들어줘"라고 요청할 때마다 서식, 차트 스타일, 데이터 처리 규칙을 매번 설명해야 한다면 생산성이 크게 떨어집니다.
이 문제를 해결하기 위해 Anthropic이 도입한 것이 바로 Agent Skills(에이전트 스킬) 시스템입니다. 스킬은 한 번 만들어 두면 필요할 때 자동으로 로드되는 재사용 가능한 전문 지식 패키지입니다. 마치 새로운 팀원에게 온보딩 가이드를 만들어주듯, 에이전트에게 특정 작업의 수행 방법을 체계적으로 알려주는 것이죠.
이번에 소개할 Agent Skills with Anthropic 강좌는 DeepLearning.AI와 Anthropic이 공동으로 제작한 단기 강좌입니다. Anthropic의 기술 교육 총괄인 Elie Schoppik이 직접 강의를 진행하며, 총 두 시간 열아홉 분 동안 스킬 시스템의 설계 원리부터 실전 활용까지 체계적으로 다룹니다. 비기너 수준으로 설계되어 있어 에이전트 개발 경험이 없어도 따라갈 수 있으며, 무료로 제공되므로 부담 없이 수강할 수 있습니다.
▲ Agent Skills with Anthropic 강좌 개요 — 강사, 시간, 학습 목표 요약
강좌는 총 열 개의 비디오 레슨과 하나의 퀴즈로 구성되어 있습니다. 스킬이 왜 필요한지에 대한 이론적 배경에서 시작하여, 기존 도구나 프로토콜과의 차이점을 명확히 비교하고, 사전 구축된 빌트인 스킬을 탐색한 뒤, 직접 커스텀 스킬을 만드는 실습으로 이어집니다. 후반부에서는 Claude API, Claude Code, Claude Agent SDK 세 가지 환경에서 스킬을 구현하고 활용하는 방법을 각각 다루므로, 자신의 개발 환경에 맞는 방식을 선택할 수 있습니다.
▲ 전체 커리큘럼 구성 — 10개 레슨별 시간 배분과 핵심 주제
2. 왜 스킬이 필요한가?
스킬이 등장하기 전까지 에이전트에게 전문 작업을 시키려면 크게 세 가지 방법이 있었습니다. 첫째는 매번 상세한 프롬프트를 작성하는 것이고, 둘째는 도구(Tools)를 정의하여 함수 호출 형태로 기능을 부여하는 것이며, 셋째는 외부 서비스를 연결하는 MCP(Model Context Protocol)를 사용하는 것입니다. 각각의 방법은 나름의 장점이 있지만, 도메인별 전문 지식을 체계적으로 관리하고 재사용하기에는 한계가 분명했습니다.
프롬프트 방식의 가장 큰 문제는 일회성이라는 점입니다. 이번 대화에서 아무리 정교한 지침을 작성해도, 다음 대화에서는 처음부터 다시 작성해야 합니다. 시스템 프롬프트에 모든 지침을 넣으면 되지 않느냐고 생각할 수 있지만, 여러 도메인의 지침을 한꺼번에 넣으면 컨텍스트 윈도우가 급격히 소비되어 실제 작업에 사용할 수 있는 공간이 줄어듭니다. 게다가 서로 다른 작업에 필요한 지침이 섞이면 에이전트의 집중도가 떨어지는 문제도 있습니다.
스킬은 이 문제들을 근본적으로 해결합니다. 스킬은 파일 시스템에 저장되는 재사용 가능한 지식 패키지로, 한 번 만들어 두면 여러 대화에 걸쳐 자동으로 사용됩니다. 핵심적인 혁신은 점진적 공개(Progressive Disclosure) 메커니즘입니다. 에이전트는 시작할 때 스킬의 이름과 설명만 가볍게 로드하고, 실제로 해당 스킬이 필요한 상황이 되었을 때 비로소 상세 지침을 읽어들입니다. 이 덕분에 수십 개의 스킬을 설치해도 컨텍스트 윈도우에 부담을 주지 않습니다.
강좌의 레슨 세번과 네번에서는 이러한 스킬의 필요성을 구체적인 사례를 들어 설명합니다. 예를 들어 동일한 형식의 엑셀 보고서를 매주 생성하는 작업, 특정 코딩 컨벤션에 따라 코드를 리뷰하는 작업, 정해진 양식으로 이메일을 작성하는 작업 등에서 스킬이 어떻게 생산성을 높이는지 보여줍니다. 스킬을 사용하면 에이전트가 마치 해당 분야의 전문가처럼 행동하게 되므로, 범용 에이전트를 전문가 에이전트로 변환하는 것과 같은 효과를 얻을 수 있습니다.
3. SKILL.md 파일 구조 이해하기
모든 스킬의 핵심은 SKILL.md 파일입니다. 이 마크다운 파일 하나가 스킬의 정체성, 트리거 조건, 실행 지침을 모두 담고 있습니다. 구조는 크게 두 부분으로 나뉩니다. 상단의 YAML 프론트매터가 메타데이터 역할을 하고, 그 아래의 마크다운 본문이 실제 지침을 담당합니다.
▲ SKILL.md 파일 구조 — YAML 프론트매터와 마크다운 지침의 분리
YAML 프론트매터에는 두 가지 필수 필드가 있습니다. name은 스킬의 고유 식별자로, 소문자와 하이픈만 사용할 수 있으며 최대 육십사 자까지 허용됩니다. description은 스킬이 무엇을 하는지, 그리고 언제 사용되어야 하는지를 설명합니다. 이 설명이 매우 중요한 이유는 Claude가 사용자의 요청을 보고 어떤 스킬을 트리거할지 결정하는 기준이 바로 이 설명이기 때문입니다. 최대 천이십사 자까지 작성할 수 있으며, 스킬의 기능과 트리거 조건을 구체적으로 명시하는 것이 좋습니다.
마크다운 본문에는 Claude가 스킬을 실행할 때 따라야 할 구체적인 지침을 작성합니다. 단계별 절차, 사용할 라이브러리, 코드 예시, 주의사항 등을 포함할 수 있습니다. 중요한 점은 이 본문이 스킬이 트리거되기 전까지는 컨텍스트에 로드되지 않는다는 것입니다. 따라서 본문이 아무리 길어도 스킬이 실제로 사용되기 전에는 토큰을 소비하지 않습니다. 이것이 시스템 프롬프트에 모든 지침을 넣는 것과 스킬을 사용하는 것의 근본적인 차이입니다.
4. 점진적 공개(Progressive Disclosure) 아키텍처
Agent Skills 시스템의 가장 혁신적인 설계 원리는 점진적 공개입니다. 이 개념을 이해하면 스킬이 왜 효율적인지, 그리고 시스템 프롬프트나 일반 도구와 어떻게 다른지가 명확해집니다. 점진적 공개란 필요한 시점에 필요한 만큼만 정보를 로드하는 전략입니다.
▲ 스킬 폴더 구조와 3단계 점진적 공개 메커니즘
스킬의 콘텐츠는 세 단계로 나뉘어 로드됩니다. 첫 번째 수준은 메타데이터입니다. 스킬의 이름과 설명만 담고 있으며, 에이전트가 시작될 때 항상 로드됩니다. 한 스킬당 약 백 토큰 정도만 소비하므로, 수십 개의 스킬을 설치해도 부담이 거의 없습니다. Claude는 이 메타데이터만 보고 어떤 스킬이 있는지, 언제 사용해야 하는지를 파악합니다.
두 번째 수준은 지침입니다. SKILL.md의 마크다운 본문에 해당하며, 스킬이 실제로 트리거될 때 로드됩니다. 보통 오천 토큰 미만으로, 절차적 지식, 워크플로, 모범 사례 등을 담고 있습니다. Claude는 사용자의 요청이 특정 스킬의 설명과 일치한다고 판단하면 bash 명령을 통해 파일 시스템에서 SKILL.md를 읽어 컨텍스트에 로드합니다.
세 번째 수준은 리소스와 코드입니다. 추가적인 마크다운 파일, 실행 가능한 스크립트, 데이터 스키마, 템플릿 등이 여기에 해당합니다. 이들은 SKILL.md의 지침에서 참조될 때만 로드됩니다. 특히 스크립트의 경우, Claude가 bash를 통해 실행하면 스크립트 코드 자체는 컨텍스트에 들어오지 않고 실행 결과만 반환됩니다. 이 덕분에 복잡한 처리 로직을 스크립트로 분리하면 토큰을 크게 절약할 수 있습니다.
▲ Agent Skills 점진적 공개 흐름 — 시스템 시작부터 결과 반환까지의 7단계
이 아키텍처의 실질적인 장점은 세 가지입니다. 첫째, 온디맨드 파일 접근이 가능합니다. 스킬에 수십 개의 참조 파일이 포함되어 있어도 작업에 필요한 파일만 선택적으로 로드합니다. 둘째, 스크립트 실행이 효율적입니다. 코드를 매번 생성하는 대신 사전에 검증된 스크립트를 실행하므로 결과의 신뢰성이 높아지고 토큰 소비도 줄어듭니다. 셋째, 번들 콘텐츠에 실질적인 제한이 없습니다. 접근하지 않는 파일은 토큰을 소비하지 않으므로 방대한 API 문서나 예제를 스킬에 포함해도 성능에 영향을 주지 않습니다.
5. Skills vs Tools vs MCP vs Subagents — 핵심 비교
강좌의 레슨 다섯번은 스킬과 기존 확장 메커니즘의 차이를 명확히 비교합니다. 이 구분은 실무에서 어떤 방식을 선택할지 결정하는 데 매우 중요합니다. 각각의 메커니즘은 서로 다른 문제를 해결하기 위해 설계되었으며, 실전에서는 이들을 조합하여 사용하는 경우가 많습니다.
▲ Skills, Tools, MCP, Subagents 핵심 비교표
도구(Tools)는 에이전트에게 특정 기능을 부여합니다. 계산기, 웹 검색, 파일 읽기 등 입력과 출력이 명확한 단일 작업을 수행하는 데 적합합니다. 함수 호출 형태로 동작하며, 에이전트가 필요한 시점에 직접 호출합니다. 하지만 도구는 "무엇을 할 수 있는가"만 정의할 뿐, "어떻게 해야 하는가"에 대한 도메인 지식은 포함하지 않습니다.
MCP(Model Context Protocol)는 외부 서비스와의 연결을 담당합니다. Slack, 데이터베이스, 외부 API 등 에이전트 밖의 세계와 소통하기 위한 표준 프로토콜입니다. MCP를 통해 에이전트는 실시간 데이터를 가져오거나 외부 시스템에 작업을 요청할 수 있습니다. 도구가 에이전트의 내부 능력이라면, MCP는 외부 세계와의 다리 역할을 합니다.
서브에이전트(Subagents)는 별도의 컨텍스트를 가진 독립적인 에이전트입니다. 메인 에이전트가 복잡한 작업을 여러 서브에이전트에게 분배하여 병렬로 처리하게 할 수 있습니다. 각 서브에이전트는 자체적인 컨텍스트 윈도우를 가지므로 메인 에이전트의 컨텍스트를 소비하지 않는다는 장점이 있지만, 생성과 관리에 비용이 듭니다.
스킬(Skills)은 이 세 가지와 본질적으로 다릅니다. 스킬은 에이전트에게 도메인별 전문 지식을 부여합니다. "무엇을 할 수 있는가"가 아니라 "어떻게 해야 하는가"를 알려주는 것이죠. 스킬은 도구처럼 기능을 제공하는 것이 아니라, 기존 기능을 더 잘 사용하는 방법을 가르칩니다. 예를 들어 파이썬으로 엑셀 파일을 다루는 것은 이미 도구로 가능하지만, 회사의 보고서 양식에 맞게 데이터를 정리하고 특정 차트 스타일을 적용하는 방법은 스킬로 전달합니다.
6. 사전 구축된 빌트인 스킬 탐색
Anthropic은 문서 작업에 가장 자주 사용되는 네 가지 스킬을 사전 구축하여 제공합니다. PowerPoint, Excel, Word, PDF 처리를 위한 빌트인 스킬로, claude.ai에서는 별도의 설정 없이 바로 사용할 수 있고 Claude API를 통해서도 skill_id를 지정하면 즉시 활용 가능합니다. 강좌의 레슨 여섯번에서는 이 빌트인 스킬들을 실제로 사용해보는 실습을 진행합니다.
▲ 사전 구축된 빌트인 스킬 4종 — PowerPoint, Excel, Word, PDF
이 빌트인 스킬들이 단순한 파일 변환 도구와 다른 점은, 전문적인 문서 작성 노하우가 내장되어 있다는 것입니다. 예를 들어 PowerPoint 스킬은 단순히 슬라이드를 만드는 것이 아니라, 시각적 계층 구조를 고려한 레이아웃, 적절한 폰트 크기와 색상 조합, 발표 흐름에 맞는 콘텐츠 배치 등 프레젠테이션 전문가의 노하우를 반영합니다. Excel 스킬 역시 데이터 정리, 수식 적용, 차트 생성 등을 모범 사례에 따라 수행합니다.
빌트인 스킬의 동작 원리를 이해하면 커스텀 스킬을 설계할 때 큰 도움이 됩니다. 빌트인 스킬도 결국 동일한 구조를 따르기 때문입니다. 메타데이터로 트리거 조건을 정의하고, 마크다운으로 상세 지침을 제공하며, 필요에 따라 스크립트를 번들하는 패턴은 커스텀 스킬에서도 그대로 적용됩니다. 강좌에서는 빌트인 스킬의 내부 구조를 살펴보며 이 패턴을 학습합니다.
7. 커스텀 스킬 직접 만들기
강좌의 레슨 일곱번은 가장 실용적인 파트 중 하나로, 커스텀 스킬을 처음부터 직접 만드는 과정을 단계별로 안내합니다. 커스텀 스킬의 핵심은 여러분의 도메인 지식, 조직의 워크플로, 반복되는 작업 패턴을 체계적으로 패키징하는 것입니다.
▲ 커스텀 스킬 생성 과정 — code-review 스킬 예시
커스텀 스킬을 만드는 과정은 크게 네 단계로 나뉩니다. 첫 번째 단계는 스킬의 목적과 범위를 정의하는 것입니다. 어떤 작업을 자동화할 것인지, 어떤 상황에서 트리거되어야 하는지, 최종 결과물은 어떤 형태여야 하는지를 명확히 합니다. 두 번째 단계는 디렉토리 구조를 생성하는 것입니다. .claude/skills/스킬이름/ 폴더를 만들고 그 안에 SKILL.md 파일을 작성합니다.
세 번째 단계는 SKILL.md의 내용을 채우는 것입니다. 프론트매터에 이름과 설명을 작성하고, 본문에 구체적인 지침을 단계별로 기술합니다. 이때 중요한 것은 지침을 Claude가 이해하고 따를 수 있을 만큼 명확하게 작성하는 것입니다. 모호한 표현 대신 구체적인 절차와 예시를 포함하면 스킬의 품질이 크게 향상됩니다. 네 번째 단계는 필요에 따라 추가 리소스를 번들하는 것입니다. 참조 문서, 유틸리티 스크립트, 템플릿 파일 등을 스킬 디렉토리에 추가하면 Claude가 필요할 때 접근할 수 있습니다.
강좌에서 다루는 커스텀 스킬 예시로는 코드 생성 및 리뷰 워크플로, 데이터 분석 파이프라인, 리서치 워크플로 등이 있습니다. 특히 코드 리뷰 스킬은 팀의 코딩 컨벤션, 보안 체크리스트, 성능 기준 등을 포함하여 일관된 품질의 코드 리뷰를 자동화하는 방법을 보여줍니다. 이러한 실전 예시를 통해 자신만의 스킬을 설계하는 감각을 기를 수 있습니다.
description 작성 모범 사례
스킬의 description은 단순한 설명이 아니라 트리거 조건의 역할도 합니다. 좋은 description은 두 가지 정보를 명확히 포함합니다. 첫째, 스킬이 무엇을 하는지 기능 설명입니다. 둘째, 언제 사용해야 하는지 트리거 조건입니다. 예를 들어 "PDF 파일에서 텍스트와 테이블을 추출합니다"는 기능 설명이고, "사용자가 PDF를 언급하거나 문서 추출을 요청할 때 사용합니다"는 트리거 조건입니다. 이 두 가지를 모두 포함해야 Claude가 적절한 시점에 스킬을 로드할 수 있습니다.
8. Claude API에서 스킬 사용하기
강좌의 레슨 여덟번은 Claude API를 통해 스킬을 프로그래밍 방식으로 사용하는 방법을 다룹니다. API 환경에서는 빌트인 스킬과 커스텀 스킬 모두를 사용할 수 있으며, 동작 방식은 동일합니다. 핵심은 코드 실행 도구와 함께 container 매개변수에 skill_id를 지정하는 것입니다.
▲ Claude API에서 Skills를 사용하는 Python 코드 예시
API에서 스킬을 사용하려면 세 가지 베타 헤더가 필요합니다. code-execution-2025-08-25는 스킬이 실행되는 코드 실행 컨테이너를 활성화합니다. skills-2025-10-02는 스킬 기능 자체를 활성화합니다. files-api-2025-04-14는 컨테이너에서 파일 업로드와 다운로드를 가능하게 합니다. 이 세 가지를 모두 betas 목록에 포함해야 스킬이 정상적으로 동작합니다.
빌트인 스킬은 skill_id(예: 'pptx', 'xlsx', 'docx', 'pdf')를 직접 참조하여 사용하고, 커스텀 스킬은 Skills API의 /v1/skills 엔드포인트를 통해 먼저 업로드한 뒤 사용합니다. 커스텀 스킬은 한 번 업로드하면 조직의 워크스페이스 전체에서 공유되므로, 팀원 모두가 동일한 스킬을 사용할 수 있다는 장점이 있습니다.
API 환경에서 주의할 점은 런타임 제약입니다. API의 스킬은 네트워크 접근이 차단되어 있어 외부 API를 호출하거나 인터넷에 접근할 수 없습니다. 또한 런타임에 새로운 패키지를 설치할 수 없으며, 사전 설치된 패키지만 사용 가능합니다. 이러한 제약을 고려하여 스킬을 설계해야 하며, 외부 데이터가 필요한 경우에는 MCP와 결합하여 사용하는 것이 좋습니다.
9. Claude Code에서 스킬 활용하기
레슨 아홉번은 강좌에서 가장 긴 레슨(이십사 분)으로, Claude Code 환경에서 스킬을 활용하는 방법을 심도 있게 다룹니다. Claude Code는 터미널에서 직접 사용하는 코딩 에이전트로, 파일 시스템 기반의 스킬 관리 방식이 가장 자연스럽게 어울리는 환경입니다.
▲ Claude Code에서 스킬 자동 트리거 데모 — 코드 리뷰 실행 과정
Claude Code에서 커스텀 스킬을 사용하는 방법은 매우 직관적입니다. 프로젝트 루트에 .claude/skills/ 디렉토리를 만들고 그 안에 스킬 폴더를 배치하면 됩니다. API 업로드나 별도의 설정 과정이 필요 없으며, Claude Code가 자동으로 스킬을 검색하여 사용합니다. 개인용 스킬은 홈 디렉토리의 ~/.claude/skills/에, 프로젝트용 스킬은 프로젝트 루트의 .claude/skills/에 배치합니다.
Claude Code 환경의 가장 큰 장점은 전체 네트워크 접근이 가능하다는 것입니다. API 환경과 달리 외부 서비스 호출, 패키지 설치 등이 자유로우므로 스킬의 기능에 제한이 적습니다. 다만 사용자의 컴퓨터에서 직접 실행되므로, 글로벌 패키지 설치보다는 로컬 설치를 권장합니다. 또한 Claude Code Plugins를 통해 스킬을 팀과 공유할 수도 있어, 팀 전체의 개발 워크플로를 표준화하는 데 활용할 수 있습니다.
강좌에서는 Claude Code 환경에서 코드 생성 스킬, 테스트 자동화 스킬, 문서 생성 스킬 등을 직접 만들고 테스트하는 실습을 진행합니다. 특히 코딩 에이전트로서의 Claude Code가 스킬을 통해 어떻게 팀의 코딩 표준을 학습하고 일관된 코드를 생성하게 되는지를 실제 예시를 통해 보여줍니다. 이 과정에서 스킬과 CLAUDE.md(프로젝트 메모리)의 차이점과 각각의 적합한 사용 시나리오도 설명합니다.
10. Claude Agent SDK와 스킬 통합
레슨 열번은 Claude Agent SDK를 사용하여 프로그래밍 방식으로 에이전트를 구축하고 스킬을 통합하는 방법을 다룹니다. Agent SDK는 TypeScript와 Python에서 커스텀 에이전트 애플리케이션을 개발할 수 있는 프레임워크로, 스킬은 이 에이전트의 역량을 확장하는 핵심 수단입니다.
Agent SDK에서 스킬을 사용하려면 두 가지 설정이 필요합니다. 첫째, .claude/skills/ 디렉토리에 스킬 파일을 배치합니다. 둘째, 에이전트 설정의 allowed_tools에 "Skill"을 포함합니다. SDK가 실행되면 자동으로 스킬을 검색하여 에이전트에 등록합니다. Claude Code와 마찬가지로 파일 시스템 기반이므로 API 업로드가 필요 없으며, 프로젝트와 함께 버전 관리가 가능합니다.
Agent SDK 환경에서 스킬이 특히 유용한 시나리오는 프로덕션 에이전트 시스템을 구축할 때입니다. 예를 들어 고객 지원 에이전트를 만든다면, FAQ 처리 스킬, 기술 문서 검색 스킬, 에스컬레이션 판단 스킬 등을 각각 만들어 에이전트에 장착할 수 있습니다. 각 스킬이 독립적으로 관리되므로 하나의 스킬을 수정해도 다른 스킬에 영향을 주지 않으며, 새로운 도메인이 추가되면 새 스킬을 만들어 디렉토리에 넣기만 하면 됩니다. 이러한 모듈성이 프로덕션 환경에서의 유지보수와 확장성을 크게 향상시킵니다.
▲ Agent Skills 지원 환경 비교 — claude.ai, API, Code, SDK
11. 스킬 + MCP + 서브에이전트 — 조합 워크플로 실전
스킬의 진정한 가치는 단독으로 사용할 때보다 다른 확장 메커니즘과 결합할 때 발휘됩니다. 강좌의 전체적인 흐름도 이 방향을 향하고 있으며, 개별 개념을 학습한 뒤 최종적으로 이들을 조합하여 복잡한 워크플로를 구성하는 것이 목표입니다.
▲ Skill + MCP + Subagent 조합 워크플로 — 매출 분석 보고서 생성 및 슬랙 전송
위 화면은 실전에서 흔히 볼 수 있는 조합 워크플로의 예시입니다. 사용자가 "매출 분석 보고서를 만들어서 슬랙으로 공유해줘"라고 요청하면, 메인 에이전트는 이를 세 가지 컴포넌트로 분해합니다. 데이터 분석 스킬이 매출 데이터를 분석하고, 서브에이전트가 차트를 병렬로 생성하며, MCP를 통해 Slack에 결과를 전송합니다. 스킬은 "어떻게 분석할 것인가"의 전문 지식을, MCP는 "어디로 보낼 것인가"의 외부 연결을, 서브에이전트는 "무엇을 병렬로 처리할 것인가"의 작업 분배를 각각 담당합니다.
이러한 조합 워크플로를 설계할 때 가장 중요한 원칙은 관심사의 분리입니다. 스킬에는 도메인 지식만 넣고, 외부 서비스 접근은 MCP에 맡기며, 독립적으로 실행 가능한 하위 작업은 서브에이전트에게 위임합니다. 이렇게 하면 각 컴포넌트를 독립적으로 개발, 테스트, 수정할 수 있어 시스템 전체의 유지보수성이 크게 향상됩니다.
강좌에서는 이러한 조합 패턴의 실제 구현 방법을 단계적으로 보여줍니다. 스킬이 MCP 서버의 데이터를 활용하여 분석을 수행하거나, 스킬의 지침에 따라 서브에이전트가 특정 패턴으로 코드를 생성하는 등의 시나리오를 실습합니다. 이 과정에서 각 컴포넌트의 장단점과 적합한 사용 시나리오를 자연스럽게 체득할 수 있습니다.
12. 수강 후기 및 추천 대상
이 강좌의 가장 큰 장점은 Anthropic 내부의 관점에서 스킬 시스템을 설명한다는 점입니다. 기술 교육 총괄인 Elie Schoppik이 직접 설계 의도와 아키텍처 결정의 배경을 설명하므로, 단순히 사용법을 배우는 것을 넘어 시스템의 설계 철학을 이해할 수 있습니다. 왜 파일 시스템 기반으로 설계했는지, 왜 점진적 공개가 중요한지, 왜 스킬과 도구를 분리했는지 등의 근본적인 질문에 대한 답을 얻을 수 있습니다.
또한 Claude API, Claude Code, Agent SDK 세 가지 환경을 모두 다루기 때문에, 자신의 개발 환경에 맞는 접근 방식을 선택할 수 있습니다. 웹 서비스를 개발하는 백엔드 개발자라면 API 레슨에 집중하면 되고, 일상적인 코딩 작업에 에이전트를 활용하고 싶다면 Claude Code 레슨이 도움이 됩니다. 프로덕션 에이전트 시스템을 구축하려는 팀이라면 Agent SDK 레슨이 핵심입니다.
추천 대상
Claude를 사용하여 반복 작업을 자동화하고 싶은 개발자, AI 에이전트의 역량을 체계적으로 확장하고 싶은 팀, MCP와 서브에이전트를 이미 사용하고 있지만 스킬 시스템을 추가로 활용하고 싶은 분, Claude Code를 주력 개발 도구로 사용하면서 커스텀 워크플로를 구축하고 싶은 분에게 특히 추천합니다.
사전 지식
비기너 수준으로 설계되어 있지만, Claude의 기본 사용법(대화, 도구 호출)을 알고 있으면 더 효과적으로 수강할 수 있습니다. Python 기초 지식이 있으면 API와 SDK 실습을 따라가기 수월하며, 마크다운 문법에 익숙하면 SKILL.md 작성이 더 편합니다.
스킬 시스템의 보안 고려사항
마지막으로 강조하고 싶은 부분은 보안입니다. 스킬은 Claude에게 새로운 기능을 부여하는 강력한 메커니즘이지만, 그만큼 악의적인 스킬이 설치될 경우 위험할 수 있습니다. Anthropic은 신뢰할 수 있는 출처(직접 만들었거나 Anthropic에서 제공한)의 스킬만 사용할 것을 강력히 권장합니다. 외부에서 가져온 스킬은 반드시 모든 파일을 철저히 검토한 뒤 사용해야 합니다. 특히 외부 URL에서 데이터를 가져오는 스킬, 예상치 못한 네트워크 호출을 포함하는 스킬, 민감한 데이터에 접근하는 스킬에 대해서는 각별한 주의가 필요합니다.
참고 링크
무료 수강 등록 및 강좌 커리큘럼 확인
스킬 아키텍처, SKILL.md 구조, 환경별 사용법 상세 안내
Agent Skills의 아키텍처와 실제 적용 사례
자주 묻는 질문 (FAQ)
시스템 프롬프트는 대화 시작 시 모든 지침이 한꺼번에 컨텍스트에 로드되어 토큰을 소비합니다. 반면 Agent Skills는 점진적 공개 방식으로 메타데이터만 먼저 로드하고, 실제로 필요한 시점에 지침을 불러옵니다. 따라서 수십 개의 스킬을 설치해도 사용하지 않는 스킬은 토큰을 소비하지 않습니다. 또한 스킬은 파일 시스템에 저장되므로 여러 대화에 걸쳐 재사용할 수 있지만, 시스템 프롬프트는 매번 새로 설정해야 합니다.
강좌는 비기너 레벨로 설계되어 있어 기초적인 코딩 지식만 있어도 따라갈 수 있습니다. SKILL.md 파일은 마크다운 형식이므로 특별한 프로그래밍 기술이 필요하지 않습니다. 다만 Claude API나 Agent SDK를 활용하는 후반부 레슨에서는 Python 기초 지식이 있으면 실습을 더 효과적으로 따라갈 수 있습니다. Claude Code 레슨은 터미널 사용에 익숙하면 도움이 됩니다.
현재 커스텀 스킬은 서피스(환경) 간에 자동 동기화되지 않습니다. claude.ai에 업로드한 스킬은 API에서 별도로 업로드해야 하고, Claude Code의 스킬은 파일 시스템 기반이라 다른 환경과 독립적입니다. 다만 Claude API에서는 워크스페이스 전체 공유가 가능하고, Claude Code에서는 Plugins를 통해 팀과 공유할 수 있습니다. claude.ai의 커스텀 스킬은 개별 사용자 단위로만 적용됩니다.
스킬 디렉토리에는 마크다운 파일, Python 스크립트, JSON 데이터, 템플릿 파일 등 다양한 종류의 파일을 포함할 수 있습니다. SKILL.md 파일만 필수이며 나머지는 선택 사항입니다. 접근하지 않는 파일은 토큰을 소비하지 않으므로 방대한 참조 자료를 번들해도 성능에 영향이 없습니다. 다만 실행 환경에 따라 사용 가능한 패키지가 다르므로, 스크립트 작성 시 해당 환경의 런타임 제약을 고려해야 합니다.
Anthropic 공식 문서의 Agent Skills 섹션에서 더 상세한 기술 문서를 확인할 수 있습니다. 특히 모범 사례 가이드는 효과적인 스킬 작성법을 깊이 다룹니다. Agent Skills Cookbook에서는 다양한 실전 예제를 제공하며, Anthropic 엔지니어링 블로그의 관련 글도 아키텍처 이해에 큰 도움이 됩니다. 또한 Claude Code 문서의 Skills 섹션에서 파일 시스템 기반 스킬 관리에 대한 추가 정보를 얻을 수 있습니다.
스킬로 에이전트를 전문가로 만드세요
Agent Skills는 범용 에이전트를 도메인 전문가로 변환하는 가장 효율적인 방법입니다.
한 번 만들면 반복해서 사용되고, 필요할 때만 로드되어 컨텍스트를 절약합니다.
'AI > Claude' 카테고리의 다른 글
| AutoAgent 완벽 가이드: AI가 스스로 에이전트를 설계하는 자율 하네스 엔지니어링 (0) | 2026.04.08 |
|---|---|
| Claude Pro, Max, Team추가 사용량 크레딧 무료 지급! (0) | 2026.04.05 |
| Claude Code Auto mode 리뷰 : 승인 팝업 없이 Claude Code 쓰는 법 (0) | 2026.03.26 |
| Claude 신기능 리뷰 — 말 한마디로 웹앱이 나오는 시대 | Artifacts 인터랙티브 시각화 (0) | 2026.03.25 |
| Claude Computer Use 완전 정복: AI가 내 컴퓨터를 직접 조종한다 (0) | 2026.03.25 |
