Anthropic의 skills playbook vs 우리의 custom knowledge layer

I’m happy to translate the article for you, but I’ll need the full text you’d like translated. Could you please paste the content (excluding any code blocks or URLs you want to keep unchanged) here? Once I have it, I’ll provide the Korean translation while preserving the original formatting and the source line exactly as you requested.

개요

Anthropic의 Claude Code 팀의 Thariq Shihipar가 최근 스킬을 내부에서 어떻게 사용하는지에 대한 스레드를 공개했습니다. 수백 개의 스킬이 활발히 사용되고 있으며, 카탈로그화된 후에는 도서관 참조, 런북, CI/CD 자동화 등 아홉 가지 카테고리로 클러스터링됩니다. 저는 CLAUDE.md 위에 레포지토리‑스코프 도메인 컨텍스트를 캡처하기 위한 지식 레이어 구축에 관한 포스트를 발표한 직후에 해당 스레드를 읽었습니다. 이 스레드는 제가 고민하던 질문에 답을 주었습니다: Anthropic 자체가 CLAUDE.md를 200줄 이하로 유지하라고 권장할 때, 깊은 도메인 지식은 어디에 보관되는가?

결과적으로 그들의 팀은 스킬을 그 용도로 사용하고 있었습니다.

솔 르윗, 선들의 위치, 1975

동일한 아키텍처, 다른 패키징

그들의 아홉 가지 카테고리를 보면, 최소 세 가지는 주로 지식 컨테이너입니다. 액션 래퍼(슬래시 명령, 트리거 설명)는 이를 발견 가능하게 만들지만, 핵심 내용은 자동화가 아니라 컨텍스트입니다.

그들의 “Gotchas 섹션 만들기” 팁은 이를 명확히 합니다: 어떤 스킬에서든 가장 신호가 강한 콘텐츠는 gotchas 섹션입니다. Claude가 무언가에 걸릴 때마다 한 줄을 추가하세요.

• Day 1 – billing-lib 스킬은 “내부 청구 라이브러리를 사용하는 방법”이라고 적혀 있습니다.
• Month 3 – 프러레이션 반올림, 테스트 모드 웹훅 간격, 멱등키 만료, 환불‑ID 의미론을 다루는 네 가지 gotchas가 추가되었습니다.

지식은 시간이 지남에 따라 축적됩니다—바로 우리 .claude/knowledge/ 파일들이 하는 일과 같습니다.

그들의 큐 디버깅 스킬은 허브‑앤‑스포크 구조를 사용합니다: 증상‑파일 라우팅 테이블이 포함된 30줄짜리 SKILL.md와 상세 내용을 담은 스포크 파일(stuck-jobs.md, dead-letters.md, retry-storms.md). 이는 우리 CLAUDE.md 지식 테이블이 .claude/knowledge/*.md 파일을 가리키는 방식과 동일합니다. 동일한 단계적 공개, 동일한 “허브는 간결하게 유지하고, 세부 사항은 스포크로 밀어내라” 원칙입니다.

하나의 원시 타입 또는 두 개

이 스레드가 두 달 전에 존재했다면, 우리는 별도의 지식 레이어를 전혀 만들지 않았을 수도 있습니다. 그들의 접근 방식은 단일 확장 지점과 단일 학습 개념만으로 같은 문제를 처리합니다—더 간단합니다.

우리가 최종적으로 만든 것은 하나의 접합점(seam)을 추가합니다:

• Knowledge files는 도메인 컨텍스트(Claude가 알아야 할 내용)를 보관합니다.
• Skills는 실행 가능한 행동(Claude가 해야 할 일)을 보관합니다.

우리는 여전히 스크립트와 훅이 포함된 스킬을 사용합니다; 구분은 컨텍스트가 자체 파일에 존재한다는 점만 의미합니다.

예시 1: 지식 파일은 데이터 파이프라인(7개의 작업, 온톨로지, S3 규칙, Elasticsearch 주의사항)을 문서화합니다. 네 개의 일반 스킬이 그 파일을 읽어 작업을 실행하고, DB를 조회하고, ES를 조회하며, S3에 접근합니다. 파이프라인마다 지식은 바뀌지만 스킬은 동일하게 유지됩니다. 스킬만 사용하는 설정에서는 해당 컨텍스트를 각 스킬에 중복해서 넣거나 전용 파이프라인‑지식 스킬에 감싸야 하므로, 최종 상태는 대략 동일합니다.

예시 2: 한 스킬이 우리 평가 스위트를 실행합니다(44줄: 데이터셋 이름, CLI 명령, 타임아웃). 결과를 해석하려면 각 데이터셋이 무엇을 테스트하는지, 알려진 약점, 최근 결과 등을 설명하는 별도의 지식 파일이 필요합니다. 누군가가 몇 달 후에 그 지식 파일을 읽으면 동일한 조사를 반복할 필요가 없고, 평가 스킬을 호출할 필요도 없습니다.

우리가 도착한 곳

다시 살펴보는 아홉 가지 카테고리:

마지막 생각. 스킬은 1년 전에는 존재하지 않았습니다. Claude Code는 명령어와 함께 출시되었고, 이후 스킬이 도입되었으며, 두 가지는 몇 달 동안 겹쳤고, 결국 명령어가 스킬로 통합되었습니다. Claude Code를 확장하기 위한 핵심 추상화는 12개월 동안 두 번 변경되었습니다.

우리가 모두 구축하고 있는 환경이 바로 그것입니다. 우리가 추가한 추가적인 경계(지식을 스킬과 분리함)는 적응성을 위한 베팅입니다. 다음 추상화 변화가 올 때, 지식은 그대로 유지됩니다. 그 주위의 연결은 변경될 수 있습니다.

작성자: Jun Suzuki
Dev.to에 게시됨