Anthropic 엔지니어 Thariq이 사내에서 수백 개의 스킬을 운영하며 경험한 인사이트를 공개했습니다. 가장 먼저 이야기 한 것은 스킬은 그냥 마크다운 파일이 아니라는 겁니다. 실제로는 스크립트, 데이터, 설정까지 포함한 폴더 단위의 에이전트 확장 도구라고 합니다.
9가지 스킬 유형과 스킬 제작 원칙 3가지를 정리해봤습니다.
———
👾9가지 스킬 유형
# 라이브러리 & API 레퍼런스
내부 라이브러리나 클로드가 자주 틀리는 SDK 사용법을 담습니다.
# 프로덕트 검증
Playwright, tmux 등과 연동해 산출물이 실제로 동작하는지 확인합니다. 검증 스킬 하나를 잘 만드는 데 엔지니어 한 명이 일주일을 투자할 가치가 있다고 강조합니다.
# 데이터 패칭 & 분석
모니터링 스택, 대시보드 ID, 쿼리 패턴을 포함해 데이터에 직접 접근합니다.
# 비즈니스 프로세스 자동화
스탠드업 포스팅, 티켓 생성 같은 반복 워크플로를 명령 하나로 줄입니다.
# 코드 스캐폴딩 & 템플릿
서비스, 마이그레이션 초기 구조를 자동 생성합니다. 코드만으로 표현하기 어려운 자연어 요구사항도 함께 담을 수 있다고 합니다.
# 코드 품질 & 리뷰
클로드가 기본적으로 잘 못하는 스타일, 테스트 방식, 리뷰를 강제합니다. 훅(Hook, 특정 조건에서 자동 실행되는 트리거)으로 자동 실행하거나 GitHub Action에 연결할 수도 있습니다.
# CI/CD & 배포
PR 모니터링, 점진적 트래픽 롤아웃, 오류 감지 시 자동 롤백까지 커버합니다.
# 런북
슬랙 알림이나 에러 시그니처를 입력받아 원인을 추적하고 구조화된 리포트를 만들어냅니다.
# 인프라 운영
고립된 리소스 정리, 의존성 관리 같은 일상적인 유지보수 작업을 처리합니다. 삭제 같은 위험한 작업도 포함되기 때문에 가이드라인을 함께 담아 실수를 방지한다고 합니다.
———
👾스킬 제작 원칙 3가지
# Gotchas 섹션을 만드세요.
Gotchas란 클로드가 실제로 실패했던 지점, 반복해서 틀리는 패턴을 모아둔 주의사항 목록입니다. 스킬에서 신호 밀도가 가장 높은 부분이라고 합니다. 처음부터 완성하려