Anthropic, 에이전트 스킬 작성 가이드 공개

Anthropic이 에이전트 스킬 작성에 관한 공식 모범 사례를 문서에 업데이트했습니다. 모델 성능 향상을 위해 구조, 명명 규칙, 테스트 방법론을 강조합니다.

명명 및 구조

스킬 이름에는 utils나 data 같은 일반 명사 대신 동명사(예: processing-pdfs)를 사용할 것을 권장합니다. 이는 스킬의 기능을 명확히 설명하기 위함입니다. 명사구 또는 동작 이름도 허용되지만, 라이브러리 전체에서 일관성을 유지해야 합니다. 파일 구성 시 참조는 한 단계 깊이로 유지해야 하며, SKILL.md에서 직접 링크하는 것이 체인 링크보다 선호됩니다. 체인 링크는 Claude가 후속 파일의 첫 100자만 미리 볼 수 있게 합니다. 하위 폴더는 허용되지만, 깊은 링크 체인은 허용되지 않습니다.

콘텐츠 최적화

에이전트가 관련성을 인식하도록, 중요한 정보가 파일 후반부(예: 350번째 줄)에 있을 경우 파일 상단에 목차를 배치할 것을 제안합니다. 에이전트가 파일 처리 여부를 판단하기 위해 첫 100줄만 읽을 수 있기 때문입니다. 설명 필드는 주요 제품 인터페이스로 취급됩니다. 제3자 시점으로 작성해야 하며, 스킬의 기능과 사용 시점을 명시하고 사용자가 검색할 가능성이 높은 주요 용어를 포함해야 합니다. 설명은 항상 로드되므로 Claude가 100개 이상의 옵션 중 올바른 스킬을 선택하는 데 결정적입니다.

개발 및 테스트

Anthropic은 "vibe checking" 대신 평가 기반 개발을 권장합니다. 개발자는 먼저 스킬 없이 Claude를 실행하여 기준선을 설정하고 실패 지점을 식별한 후, 개선 사항을 측정하기 위한 최소한의 테스트 시나리오를 구축해야 합니다. 아직 내장 평가 도구가 없으므로 개발자가 직접 만들어야 합니다. 또한 점진적 공개 원칙이 강조됩니다. 시작 시 시스템 프롬프트에는 이름과 설명만 포함하고, SKILL.md는 관련 있을 때만 로드하며, 추가 파일은 필요할 때만 로드해야 합니다. SKILL.md는 500줄 미만으로 유지해야 합니다. 마지막으로, Opus와 Haiku 등 모델 간 성능 차이가 있을 수 있으므로 모든 대상 모델에서 스킬을 테스트해야 합니다.