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