skills
무엇인가
Anthropic이 Claude용으로 구현한 Agent Skills의 레퍼런스 저장소다. 모델 가중치를 바꾸는 것이 아니라, 작업별 절차를 파일로 분리해 필요할 때 컨텍스트에 주입하는 확장 계층에 해당한다. 창작·설계, 개발·테스트, 기업 워크플로, 문서 생성 스킬이 함께 들어 있다.
어떻게 동작하나
스킬 하나는 독립된 폴더이고, 그 안의 SKILL.md가 단위다. SKILL.md는 YAML frontmatter와 마크다운 본문으로 나뉘며, frontmatter에는 name(소문자, 공백 대신 하이픈)과 description 두 필드가 필수다. 본문에는 Claude가 따를 지침·예시·가이드라인이 들어가고, 폴더에는 스크립트와 리소스를 함께 둘 수 있다. 저장소는 ./skills(예제), ./spec(Agent Skills 명세), ./template(스킬 템플릿)로 나뉜다.
무엇과 다른가
파인튜닝이나 시스템 프롬프트에 절차를 직접 넣는 방식과 달리, 스킬은 파일로 존재하다가 해당 작업이 걸릴 때 동적으로 로드된다. 도구를 프로토콜로 노출하는 MCP 서버와도 층이 다르다. 스킬은 도구 호출 규격이 아니라 선언적 지침 문서다. 라이선스도 갈린다. 예제 스킬 다수는 Apache 2.0이지만, Claude의 문서 기능을 구동하는 skills/docx·pdf·pptx·xlsx는 소스 공개(source-available) 조건이다.
어떻게 쓰나
Claude Code에서는 이 저장소를 플러그인 마켓플레이스로 등록한 뒤 Browse and install plugins에서 anthropic-agent-skills를 고르고 document-skills 또는 example-skills를 설치한다. 설치 후에는 스킬 이름을 언급하는 방식으로 호출한다. Claude.ai 유료 플랜에는 예제 스킬이 기본으로 들어가 있고, Claude API로는 사전 제작 스킬과 직접 만든 스킬을 함께 올릴 수 있다. 새 스킬은 template-skill을 복사해 SKILL.md를 채우면 된다.
전제와 한계
저장소의 스킬은 시연·교육 목적으로 공개된 것이다. 같은 이름의 기능이 Claude에 있더라도 실제 구현과 동작이 다를 수 있으므로, 중요한 작업에 쓰기 전에 자기 환경에서 검증해야 한다. 문서 스킬 4종은 오픈소스가 아니라 참조용 소스 공개다. 스킬 정의는 SKILL.md 하나와 폴더 구조라는 최소 형식만 요구한다.
관련 논문 2
유사 스킬
- claude-skills13개 AI 코딩 도구에서 공통으로 쓰는 Claude Code 스킬·플러그인 모음이다. SKILL.md 지침과 표준 라이브러리만 쓰는 Python CLI 도구로 구성된다.
- agent-skillsAI 코딩 에이전트에 카테고리별 SKILL.md 규칙 묶음을 설치해 워크플로·패턴·검증 절차를 주입하는 관리형 스킬 레지스트리 CLI다.
- skills여러 저장소에서 SKILL.md 규칙 파일을 받아 Claude Code·Codex·Cursor 등 지정한 에이전트의 규칙 위치에 설치·갱신·제거하는 CLI다.
- cc-skills커밋·브랜치 명명, Chrome 확장 MV3 구조, 카피라이팅 훅·CTA, 기술 글쓰기 규칙을 SKILL.md 단위로 쪼개 필요할 때만 컨텍스트에 로드하는 Claude Code 플러그인이다.
- humanizerAI가 쓴 티가 나는 문장을 의미 변경 없이 사람이 쓴 것처럼 고쳐 쓰는 Markdown 기반 에이전트 스킬이다. Skills CLI로 설치해 /humanizer로 호출한다.