Claude Skills 해부: 프롬프트부터 실전까지, 개발자가 분석한 AI 워크플로우

Claude Skills(Anthropic의 AI 에이전트 기능)의 내부 구조를 역설계한 심층 분석. Skills는 복잡한 작업을 자동화하면서도 사용자 통제권을 유지하는 실용적 접근으로, 코드 실행이 아닌 프롬프트 주입을 통해 Claude AI의 행동을 변경.

주요 내용:

1. 핵심 개념: Skills는 프롬프트 템플릿

• Skills는 Python/JS 같은 실행 코드를 사용하지 않고, 도메인 특화 지시사항(예: PDF 처리 가이드)을 대화 맥락에 주입.
• 일반 도구(Read, Write, Bash 등)와 달리 즉시 실행되지 않고, Claude가 "준비"되도록 도움. 예: PDF skill 호출 시 500~5,000단어의 상세 프롬프트가 숨겨진 메시지로 전송.

2. 메타-툴 아키텍처

• 'Skill' 메타-툴이 모든 개별 skills(PDF, skill-creator 등)를 관리하며, LLM 추론만으로 사용자 의도를 매칭. (임베딩/분류기 없음)
• 실행 시 두 메시지 주입: UI에 보이는 간결 XML 상태("PDF skill 로딩 중")와 숨겨진 전체 가이드.

3. SKILL.md 구조와 리소스

• 프론트매터(YAML): name, description(Claude 선택 신호), allowed-tools(자동 승인 도구, 보안 고려), model 지정.
• 마크다운 콘텐츠: 워크플로우, 도구 사용 순서, 출력 형식 지시 (5,000단어 이내).
• 지원 디렉토리: scripts/(자동화 스크립트), references/(참조 문서), assets/(템플릿/이미지, 토큰 절약).

4. 실행 맥락 수정과 패턴

• Skill 호출 시 도구 권한 자동 변경(임시 승인)과 모델 전환 가능 (contextModifier 함수 구현).
• 실전 패턴:
  • 스크립트 자동화: 다단계 작업 스크립트 실행.
  • 읽기-처리-쓰기: 데이터 변환/정리.
  • 검색-분석-보고: 코드베이스 분석 (Grep 활용).
  • 마법사 워크플로우: 단계별 사용자 확인.

5. 한계와 의미

• 단점: 동시성 미지원, 토큰 오버헤드(1,500+), 프롬프트 의존성.
• 장점: 유연성·안전성 강조. "중요 결정은 사람, 반복은 AI" 협업 모델 제시. AI 에이전트 미래 방향으로, 프롬프트 기반 구현이 핵심.

(원문 출처: leehanchung.github.io, 2025.10.26 게시)