Claude Skills: AI 에이전트에 재사용 가능한 전문 역량을 패키징하는 새로운 방식

Who Should Read

Claude Code나 Claude API를 쓰면서 반복적인 워크플로우(문서 생성, 코드 분석, 브랜드 가이드 적용 등)를 자동화하고 싶은 개발자. CLAUDE.md가 너무 비대해지는 문제를 겪고 있는 팀 단위 Claude 사용자.

Core Mechanics

• Skills는 지침(SKILL.md), 스크립트, 리소스를 묶은 폴더 구조다. Claude가 작업 중에 어떤 Skill이 관련 있는지 스캔하고, 매칭되면 해당 Skill만 로드한다. 전체를 항상 컨텍스트에 올리지 않아서 토큰 낭비를 줄인다.
• Skills는 Composable(여러 Skill 동시 적용), Portable(Claude 앱·Claude Code·API 동일 포맷), Efficient(필요할 때만 로드), Powerful(실행 가능한 코드 포함 가능)이라는 4가지 특성을 갖는다.
• API에서는 Messages API 요청에 Skills를 붙이거나 /v1/skills 엔드포인트로 버전 관리를 할 수 있다. Skills 실행에는 Code Execution Tool 베타가 필요하다.
• Anthropic이 직접 만든 공식 Skill로 Excel 스프레드시트(수식 포함), PowerPoint, Word 문서, 채울 수 있는 PDF 생성이 가능하다. 이 기능들은 이미 Claude 앱에서 쓰이고 있던 것들이다.
• Pro/Max/Team/Enterprise 플랜 사용자는 Claude 앱에서 Skills를 쓸 수 있다. Team/Enterprise는 관리자가 조직 전체 Skills를 설정할 수 있다.
• 'skill-creator'라는 내장 Skill을 쓰면 Claude가 대화형으로 Skill을 만들어준다. 워크플로우를 설명하면 폴더 구조와 SKILL.md를 자동 생성해준다.
• 2025년 12월 업데이트로 조직 단위 Skills 관리, 파트너가 만든 Skills 디렉터리, 그리고 크로스 플랫폼 이식을 위한 오픈 스탠다드가 추가됐다.
• Subagent와의 차이점은 명확하다. Skills는 현재 Claude 인스턴스에 공유 컨텍스트로 추가되는 것이고, Subagent는 별도 컨텍스트 창을 가진 독립적인 Claude 인스턴스다. 둘을 조합하는 것도 가능하다.

Evidence

• Simon Willison은 'Claude Skills are awesome, maybe a bigger deal than MCP'라고 평가했다. Skills가 MCP보다 더 큰 의미를 가질 수 있다는 시각인데, 반면 일부 댓글에서는 'MCP와 Skills의 차이가 결국 JSON이냐 마크다운이냐 정도 아니냐'는 회의적 시각도 있었다.
• CLAUDE.md 비대화 문제를 지적하는 댓글이 호응을 얻었다. 큰 코드베이스에서 CI, E2E 테스트 등 니치한 워크플로우가 CLAUDE.md에 쌓이면 컨텍스트 오염이 심각해지는데, Skills를 쓰면 '문제별로 토큰을 선택'할 수 있다는 점이 핵심 장점으로 꼽혔다.
• Claude가 어떤 Skill을 언제 써야 할지 판단하는 능력에 대한 의문이 제기됐다. 인간은 경험이 쌓이면서 도구 선택이 나아지지만, Claude는 항상 description 블러브에서 시작하기 때문에 Skill이 많아질수록 선택 품질이 떨어진다는 우려다. 이에 대해 'slash command가 더 낫다'는 의견도 있었다.
• 개념 혼란에 대한 피로감을 토로하는 댓글이 많았다. Tools, Functions, Skills, Agents, Subagents, Commands, Apps, Hooks, MCP, Memory, Extended Thinking... 이 많은 개념들이 서로 겹치고 복잡하게 얽혀 '프론트엔드 프레임워크 전쟁 급의 개념 혼란이 오는 거 아니냐'는 우려가 공유됐다.
• 실제 활용 사례로, 프로젝트마다 bin/claude 디렉터리를 만들고 CLAUDE.md에서 해당 디렉터리를 참조하게 해서 BigQuery 분석 도구나 크리덴셜 파일 위치 등을 Claude가 자동으로 알게 하는 패턴을 쓰고 있다는 경험담이 공유됐다. Skills의 공식 도입 전에 이미 비슷한 방식으로 쓰고 있었던 셈이다.

How to Apply

• CLAUDE.md가 너무 커져서 컨텍스트를 잡아먹는다면, 특정 워크플로우(CI 자동화, E2E 테스트 실행, 데이터 분석)를 Skills 폴더로 분리해라. Claude가 해당 작업 요청 시에만 로드하므로 일반 대화 품질이 개선된다.
• Excel/PowerPoint/Word 생성이 필요한 서비스를 API로 구축 중이라면, Anthropic 공식 Skills를 Messages API에 붙이는 방식을 검토해라. 수식 포함 Excel 파일 생성을 직접 구현하는 것보다 훨씬 빠르게 구축 가능하다.
• 조직 내 여러 팀이 Claude를 쓰는 상황에서 브랜드 가이드라인, 코딩 컨벤션, 문서 템플릿 등을 Skills로 패키징하면 관리자가 조직 전체에 일괄 배포할 수 있다. Enterprise 플랜에서 admin 권한으로 설정 가능하다.
• 자체 Skill을 만들 때는 'skill-creator' 내장 Skill을 활용해라. Claude에게 워크플로우를 설명하면 폴더 구조와 SKILL.md를 자동으로 생성해줘서 처음 구조를 잡는 데 드는 시간을 아낄 수 있다.

Terminology

관련 논문

• OpenKnowledge – Obsidian/Notion의 오픈소스 AI-first 대안

  Git 기반 동기화와 Claude/Codex/Cursor 연동을 내장한 로컬 우선 마크다운 에디터로, AI 에이전트의 두 번째 뇌(LLM Wiki)로 활용할 수 있는 오픈소스 도구다.

• Unfireable Safety Kernel: AI 에이전트를 위한 Execution-Time AI Alignment

  AI 에이전트가 자신의 안전장치를 우회할 수 없도록, 에이전트 프로세스 바깥에 수학적으로 증명된 강제 통제 게이트를 배치하는 아키텍처

• RubyLLM: 주요 AI 프로바이더를 모두 지원하는 Ruby 프레임워크

  OpenAI, Claude, Gemini 등 주요 AI 프로바이더를 단일 인터페이스로 통합한 Ruby 프레임워크로, Rails 통합과 에이전트 기능까지 지원해 Ruby 개발자가 AI 기능을 빠르게 붙일 수 있다.

• Qwen-AgentWorld: 범용 에이전트를 위한 Language World Model

  Alibaba Qwen 팀이 AI 에이전트가 행동 결과를 미리 시뮬레이션할 수 있는 'Language World Model'을 공개했다. 에이전트 훈련과 실행 경로 검증에 새로운 패러다임을 제시하는 연구다.

• SHERLOC: Code Repair Agent를 위한 구조화된 Diagnostic Localization 프레임워크

  버그 위치만 알려주는 게 아니라 '왜, 어떻게 고쳐야 하는지'까지 진단 리포트를 생성해서 코드 수정 에이전트의 성능을 높이는 training-free 프레임워크

• peerd – 브라우저에서 완전히 실행되는 AI Agent Harness

  백엔드 서버 없이 Chrome/Firefox 확장 프로그램으로만 동작하는 AI 에이전트 실행 환경으로, 브라우저 탭을 직접 조작하고 WASM Linux VM까지 구동할 수 있어 프라이버시와 보안을 동시에 챙길 수 있다.

Related Resources

• https://www.anthropic.com/news/skills
• https://simonwillison.net/2025/Oct/16/claude-skills/
• https://simonwillison.net/2025/Oct/10/claude-skills/
• https://blog.fsck.com/2025/10/09/superpowers/
• https://github.com/ryancnelson/deli-gator