Anthropic told you how they use Claude Code skills. The buried line: your skills/ directory is now a hiring signal.

개요

Anthropic의 Claude Code 팀은 엔지니어의 생산성을 극대화하기 위해 'skills'를 핵심 요소로 활용하며, 이는 개별 엔지니어의 역량을 강화하고 후보자의 skills/ 디렉토리를 포트폴리오로 간주하게 만듭니다.

주요 내용

* Skills의 핵심 역할: Anthropic은 Claude Code에서 skills를 코드 리뷰, 릴리스 관리, PR 트리아지, 사고 대응, 고객 지원 라우팅 등 다양한 내부 워크플로우에 활용합니다.
* Skills 저장 및 트리거 방식: Skills는 개인 홈 디렉토리가 아닌 리포지토리 또는 공유 에이전트 디렉토리에 체크인되며, 프롬프트에서 skill로의 디스패치는 skill 설명의 퍼지 매칭(fuzzy matching)을 통해 이루어집니다.
* Skill 트리거 품질: Skill 트리거 품질은 설명(description)의 명확성에 크게 의존하며, 뛰어난 skill 작성 능력은 코딩 능력만큼이나 중요합니다.
* Leverage 측정: Anthropic의 시니어 엔지니어는 자신의 skills가 팀 동료 및 다운스트림 에이전트에 의해 얼마나 자주 사용되는지를 leverage의 측정 기준으로 삼습니다.
* 시스템 프롬프트의 한계: Anthropic은 긴 시스템 프롬프트보다 관련성이 높은 수십 개의 짧고 잘 설명된 skills를 사용하는 것을 지향합니다.
* Skills의 지식 전달 역할: Skills는 문서, Slack 스레드, 온보딩 덱보다 효과적인 크로스팀 지식 전달 수단으로 간주됩니다.
* Skill 설명의 중요성: Skill 설명은 메타데이터가 아니라 API 역할을 하며, 자연스러운 표현을 포함하여 명확하고 열거적인 방식(coverage by enumeration)으로 작성되어야 합니다.
* Skill 작성의 실질적 측면: Skill 본문은 길고 상세할 수 있으며, 코너 케이스 및 작동 예시를 포함해야 하는 반면, 설명은 간결하고 디스패치에 최적화되어야 합니다.
* Leverage 측정 및 관리: Skills/ 디렉토리의 사용량을 추적하고, 트리거 횟수가 낮은 skills는 삭제하며, 상위 skills 작성자를 인정해야 합니다.
* 채용에서의 Skills 활용: Skills/ 디렉토리는 AI 네이티브 팀의 엔지니어링 역량을 평가하는 중요한 포트폴리오 신호로 사용될 수 있습니다.
* Skill 충돌, 설명 드리프트, Skill 묘지 등의 실패 모드: Skill 충돌, 워크플로우 변경으로 인한 설명 드리프트, 미사용 skills의 방치, 저자 종속성, 파괴적 작업에 대한 예측 불가능한 트리거 등이 주요 실패 모드입니다.
* AI 네이티브 엔지니어링 팀의 미래: AI 네이티브 엔지니어링 팀은 코드를 많이 작성하는 팀보다 소규모의 재사용 가능한 지시 단위를 작성하는 팀에 가까워질 것입니다.

시사점

AI 네이티브 팀에서는 엔지니어의 prose(글쓰기) 역량이 leverage를 결정하는 핵심 요소가 되며, 이는 채용 및 성과 평가 방식의 변화를 요구합니다.