[AI] AI Agent 결국엔 도구(Skill) 싸움이다.

도구 싸움

최근 Claude Code 로 열심히 씨름하다가 깨달은 새로운 내용입니다.

AI Agent 가 반복되는 사이클 돌면서 도구를 호출해서 일 하는게 전부구나 (너 사실 단순하구나?)  

도구(skill)을 잘 쥐어주는게 중요하다는 것을 깨달았습니다.

 

내가 아무리 명령을 많이 내려도 좋은 결과물을 못 뽑아낸다면

그건 내 탓아님. 도구 탓이다. 그렇게 생각하세요

(옛날에 롤할때 원딜들이 서폿에게 하던 말 아닌가)

 

Skill 이 뭔데?

Skills는 Claude에게 도메인별 전문 지식을 제공하는 재사용 가능한 파일시스템 기반 리소스입니다.

워크플로, 컨텍스트, 모범 사례를 통해 범용 에이전트를 전문가로 변환합니다. 프롬프트(일회성 작업을 위한 대화 수준의 지침)와 달리, Skills는 필요에 따라 로드되며 여러 대화에서 동일한 안내를 반복적으로 제공할 필요를 없앱니다.

 

 

Skill 예시

클로드가 PDF 를 이해하는건 잘하는데 PDF 를 조작하는건 잘할까요?

아무리 시켜봐도 만족스러운 결과가 안나올 수 있습니다.

그럴 때 필요한게 PDF 스킬이죠.

 

메타데이터

pdf/SKILL.md 파일을 만들고, 클로드가 스킬을 언제 사용해야하는지 알 수 있는 메타데이터를 작성합니다. (스킬의 이름과 설명)

• skill_id : 고유 식별자 (예: "xlsx", "pptx")
• 버전 : 버전 번호 또는 "최신"
• 이름 : 사람이 읽을 수 있는 이름
• 설명 : 이 스킬의 기능
• 디렉토리 : 스킬의 폴더 구조

 

본문에는 세부 정보를 작성합니다. 개요, 실행 방법 등이 작성되어 있습니다.

 

클로드가 메타데이터를 읽고 현재 작업과 관련있다고 판단하면 전체 정보를 읽어와서 컨텍스트에 로드합니다.

그런데 본문 내용이 너무 길어진다면, 링크 파일을 두어서 찾아가게 합니다.

 

물론 이러한 지식, 정보 외에도 실행 가능한 코드를 제공할 수도 있죠.
이 기능을 수행하기 위해 어떠한 위치의 파이썬 코드를 읽어라고 할 수도 있습니다.

 

즉, 스킬이란 참고 문서 역할도 가능하고 실행 가능한 도구의 역할도 가능합니다.

정리하자면 3단계 로딩 모델을 가짐

1. 메타데이터 (이름: 64자, 설명: 1024자): 클로드는 스킬 이름과 설명을 봅니다. 
2. 전체 지침 (<5천 토큰): 스킬이 관련될 때 로드됨 
3. 연결된 파일 : 필요한 경우에만 추가 리소스가 로드됩니다.

 

저는 실제로 클로트 코드를 사용하면서

반복될 수 있는 작업을 모두 파이썬 스크립트로 만들면서 진행했는데요.

"이런 상황에서는 이 스크립트를 쓰세요" 라고 매번 알려주지 않아도 스킬에 등록하면 알아서 클로드가 사용할 수 있겠죠?
이런 용도입니다.

 

xlsx, pptx, pdf,docx 등은 엔트로픽에서 관리하는 사전 구축된 스킬들입니다.

 

Skill 찾기

Vercel 에서 만든 Skill 디렉토리를 참고해보세요.

쓸 만한 스킬 검색 -> 스킬 사용

The Agent Skills Directory

 

회사 내 프로젝트안에서 claude.md, skill.md 를 어떻게 구축하면

팀 내에서 공통화된 룰 아래에서 AI Agent 를 동작시키게 하고, skill 을 통한 개발 생산성을 끌어올릴까?

요즘 이런 고민들이 듭니다.

저도 그렇고 동료들이 AI 를 개별적으로는 참 잘 이용하는데, 팀 전체에서는 크게 활용을 하고 있지는 못하고 있어서요.