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

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