Anthropic Agent Skills — 스킬 빌드

MCP·Skill / 스킬 빌드 / skills.html

스킬 빌드원문등록 2026-10-18

Claude 에이전트용 스킬 표준과 공식 스킬 모음

기본 정보

프로그램 이름	Anthropic Agent Skills (앤스로픽 에이전트 스킬)
한 줄 소개	Claude 에이전트용 스킬 표준과 공식 스킬 모음
개발·유지	Anthropic
공식 홈페이지	https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills
공식 문서	https://github.com/anthropics/skills
설치·배포	git clone https://github.com/anthropics/skills
동작 환경	Claude Code · Claude Desktop · 호환 에이전트
라이선스	Anthropic 스킬 라이선스 (저장소 참고)
안정 버전	GitHub main 브랜치 (2026-10-09 push) — 확인일 2026-10-18
GitHub 저장소	https://github.com/anthropics/skills
분류	스킬 빌드 (태그: Skill, 에이전트, Claude, SKILL.md, 워크플로)

이 프로그램은 무엇인가?

Agent Skills는 에이전트에게 특정 작업을 잘하도록 만든 지침·스크립트·리소스를 폴더 단위로 묶은 패키지입니다. 각 스킬은 SKILL.md라는 마크다운 파일로 작업 방법을 설명하고, 필요하면 스크립트·템플릿 같은 보조 파일을 함께 둡니다.

Anthropic이 Claude용으로 처음 제안했지만, SKILL.md 형식은 Claude Code 이외의 에이전트로도 확장되고 있습니다. 스킬은 자동으로 발견되어 로드되므로, 범용 에이전트를 특정 작업 전문가로 바꾸는 데 사용합니다.

어떤 문제를 해결하는가?

에이전트에게 반복적으로 같은 작업 지침을 설명해야 하는 상황
조직·팀의 워크플로를 에이전트에 일관되게 전달해야 하는 상황
MCP 서버 없이 로컬 지침·스크립트로 전문성을 확장해야 하는 상황

주요 기능

SKILL.md 표준

YAML 프론트매터와 마크다운으로 스킬 정의

활용 상황: 일관된 스킬 형식
얻는 결과: 이름·설명·지침을 한 파일에 관리
제한 사항: 설명 품질이 자동 호출 정확도에 영향

자동 발견

작업이 스킬 설명과 맞으면 자동 로드

활용 상황: 사용자 개입 없이 전문 지식 적용
얻는 결과: 적절한 스킬 선택으로 정확도 향상
제한 사항: 스킬이 많으면 선택 경합 발생 가능

보조 리소스

스크립트·템플릿·레퍼런스 파일 포함 가능

활용 상황: 실행 가능한 워크플로 제공
얻는 결과: 재사용 가능한 코드 번들
제한 사항: 파일 크기·구조 관리 필요

커뮤니티 생태계

Anthropic 공식 스킬 + 커뮤니티 스킬

활용 상황: 빠른 스킬 확보
얻는 결과: xlsx·webapp-testing 등 공식 스킬
제한 사항: 타 에이전트 호환성 확인 필요

설치 및 실행

공식 스킬 저장소

anthropics/skills를 클론해 원하는 스킬을 복사합니다.

git clone https://github.com/anthropics/skills

Claude Code에 설치

스킬 폴더를 Claude Code의 skills 디렉터리에 배치합니다.

cp -r skills/pdf-skills ~/.claude/skills/

직접 작성

SKILL.md를 만들고 디렉터리에 보관합니다.

mkdir my-skill && touch my-skill/SKILL.md

실제 사용 예제

스킬 디렉터리 확인

설치된 스킬 목록을 확인합니다.

ls ~/.claude/skills/

스킬 작성

SKILL.md에 YAML 프론트매터와 지침을 작성합니다.

---
name: my-skill
description: ...
---
# 지침...

에이전트가 호출

작업을 요청하면 에이전트가 관련 스킬을 자동 로드합니다.

예: '이 PDF를 요약해줘' → pdf 스킬 자동 로드

장점과 한계

장점

Anthropic이 제안한 에이전트 전문성 확장 표준
SKILL.md만 알면 어디서나 스킬 작성 가능
MCP 없이도 로컬 지침으로 전문성 확장
18만+ stars의 공식 저장소와 커뮤니티 생태계

사용 전에 고려할 점

완전한 기능은 Claude 계열 에이전트에 최적
타 에이전트로의 이식은 호환성 확인 필요
스킬 설명 품질에 따라 자동 호출 성공률이 달라짐

비슷한 프로그램과 비교

프로그램	특징	이런 경우에 적합
MCP 서버	외부 도구·API를 프로토콜로 연결	실제 시스템 연동
System Prompt	시스템 프롬프트에 지침 내장	간단한 고정 지침
RAG	문서 검색으로 지식 제공	대규프 문서 기반 답변

공식 자료 및 추가 학습

공식 홈페이지 — https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills
공식 문서 / 지식베이스 — https://github.com/anthropics/skills
설치·배포 — git clone https://github.com/anthropics/skills
릴리스 노트 — https://github.com/anthropics/skills/commits/main
소스 / 개발 자료 — https://github.com/anthropics/skills

버전·지원 환경 정보는 2026-10-18 기준으로 공식 사이트에서 확인한 값입니다. 설치 명령은 사용하는 배포판과 버전에 따라 달라질 수 있으므로 공식 설치 문서를 함께 확인하세요.

실제 실행 화면

합성 예시 — 실제 실행 결과가 아닙니다. 화면은 합성 예시이며 실제 실행 결과가 아닙니다.

Agent Skills 디렉터리와 SKILL.md 예시

실제 운영 중인 서버

이 문서는 화면 표시용 가상 디렉터리의 항목입니다. 실제 서버 파일시스템과 연결되지 않으며, 파일 실행이나 시스템 명령을 수행하지 않습니다.