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

관련 논문

• 프로덕션 AI 에이전트를 GPT-5.6으로 마이그레이션: 2.2배 빠르고 27% 저렴

  마케팅 웹사이트를 자동 생성하는 프로덕션 AI 에이전트를 Claude Opus 4.8에서 GPT-5.6 Sol로 전환한 실전 경험담으로, 단순 모델 교체가 아니라 eval 하네스, 툴 스키마, 캐싱, 추론 리플레이까지 손봐야 했던 과정을 구체적인 수치와 함께 정리했다.

• xAI Grok Build CLI가 xAI 서버로 전송하는 데이터: 네트워크 레벨 분석

  xAI의 공식 코딩 CLI 도구 Grok Build가 사용자 동의 없이 전체 Git 저장소와 .env 시크릿 파일을 xAI 서버로 업로드한다는 사실이 네트워크 트래픽 분석으로 밝혀졌다.

• 중요할 때 기억하라: Long-Horizon 에이전트를 위한 Proactive Memory Agent

  LLM 에이전트가 긴 작업 중 중요한 정보를 잊어버리는 문제를 별도의 메모리 에이전트가 '적절한 타이밍에' 끼어들어 해결하는 방법

• WebSwarm: 깊고 넓은 웹 검색을 위한 재귀적 Multi-Agent Orchestration

  복잡한 웹 검색을 재귀적으로 분해하고 각 노드에 적합한 검색 모드를 동적으로 할당하는 멀티에이전트 프레임워크

• 웹 앱을 리버스 엔지니어링해서 AI Agent 도구로 자동 변환하기

  로그인된 웹 앱의 API 호출을 브라우저에서 감시해 자동으로 MCP 도구로 변환하는 에이전트를 만들었다. 소스 코드나 공식 API 문서 없이도 Jira, Spotify 같은 서비스에 AI 어시스턴트를 붙일 수 있다.

• FableCut – AI 에이전트가 조작할 수 있는 브라우저 기반 비디오 에디터 (zero deps)

  타임라인 전체를 JSON 파일 하나로 표현하고 MCP/REST로 AI 에이전트가 직접 편집할 수 있는 브라우저 비디오 에디터로, Claude 같은 AI가 프롬프트 하나로 영상을 자동 컷편집하고 결과를 실시간으로 UI에 반영해준다.

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