지난 5월 27일과 6월 10일, 요즘IT는 '클코나잇 2' 웨비나를 개최했습니다. 지난해 진행한 클코나잇 시즌 1에 이어, 이번 웨비나에서는 개발자와 비개발자를 포함한 다양한 직군의 실무자들이 클로드 코드(Claude Code)를 업무에 활용한 경험을 공유했는데요. 참가자들은 "고수의 경험을 나눠 받을 수 있는 기회", "찐 실무자의 현장감 넘치는 사례", "다음에 또 오고 싶은 웨비나" 등의 반응을 보였습니다. 이번 글에서는 아쉽게도 참석하지 못한 분들을 위해, 웨비나의 핵심 내용만 모아 콘텐츠로 정리했습니다.

클코나잇 2 웨비나의 세 번째 발표였던 '스킬을 다루는 스킬'입니다. 발표 자료는 요즘IT 디스코드에서 다운로드 받을 수 있습니다.

안녕하세요. 저는 스킬을 묶어서 워크플로우를 자동화하는 방법에 대해 발표할 프리랜서 개발자 김규동입니다. 저는 대학교 재학 중에 3인 팀으로 외국인 유학생을 위한 앱을 만들었고, 졸업 후에 그 앱을 유지 보수하면서 클로드 코드와 코덱스를 활용해 매주 개발을 하고 있습니다. 그 과정에서 스킬을 직접 만들고 관리하며, 얻은 경험들을 공유하고자 합니다.

첫 번째로 스킬을 생성, 조회, 수정, 삭제하는 기본적인 관리법에 대해 설명드리고, 두 번째로 자주 반복되는 스킬들을 하나의 마스터 스킬로 묶어 워크플로우를 자동화하는 방법에 대해 발표하겠습니다.

스킬은 '투창'이다: 긴 프롬프트를 한 단어로

우선 스킬(Skill)이 무엇인지부터 정리하겠습니다. 클로드 코드 공식 문서에 따르면, 스킬은 지침, 지식, 또는 클로드의 도구 키트에 추가하는 워크플로우를 포함하는 SKILL.md 파일입니다. 사실 저는 이 정의만으로는 잘 이해가 되지 않았습니다.

그래서 스킬을 사용하면서 제가 느낀 스킬의 정의는 다음과 같습니다. 저는 게임 스킬로 비유해서 이해했습니다. '적에게 창을 던져 물리 피해를 입힙니다'라는 게임 스킬이 있다고 해보죠. 이 게임 스킬을 클로드 코드에서 사용한다면, 프롬프트로 "적에게 창을 던져 물리 피해를 입힙니다"라고 적을 수 있습니다. 게임에서 스킬을 사용할 때마다 매번 모든 스킬 설명을 말하면 힘드니까 짧게 '투창'이라고 줄여서 사용하듯이, 매번 긴 프롬프트를 입력하는 대신 '스피어샷'이라는 한 단어만 입력해도 동일한 결과가 나오게 만드는 것. 저는 스킬을 이렇게 이해했습니다.

스킬 크리에이터로 만들고, 검증까지 한다

다음으로 스킬을 만드는 방법입니다. 스킬을 만들 때 그냥 "OO 스킬 만들어줘"라고 해도 클로드가 잘 만들어주지만, 품질을 위해 추천하는 도구가 있습니다. 앤트로픽에서 만든 공식 플러그인인‘스킬 크리에이터(Skill Creator)’입니다. 만약 이 플러그인이 설치되지 않았다면, 클로드 코드에게 "앤트로픽 공식 플러그인인 스킬 크리에이터 설치해줘"라고 하면 잘 설치해 줄 겁니다.

기존에는 그냥 스킬을 만들어달라고 하면 스킬 만들고 끝이고, 나중에 그 스킬을 사용했을 때 원하지 않는 결과가 나온 경우가 있었습니다. 하지만 이 플러그인을 이용해 "OO 스킬 만들어줘"라고 요청하면 제 요구 사항에 대한 인터뷰가 진행됩니다. 그리고 서브 에이전트들을 이용해 스킬을 사용한 에이전트와 사용하지 않은 에이전트를 병렬로 돌려서, 그 스킬을 사용했을 때와 사용하지 않았을 때를 비교해 줍니다. 그래서 만들어진 스킬이 정말 의미 있는지 확인할 수 있습니다.

안 쓰는 스킬은 과감히 정리할 것

이렇게 스킬을 여러 개 만들어두고 쓰게 되면, 사실 만들어 두고 쓰지 않는 스킬들도 꽤 많이 쌓입니다. 그럴 땐 "스킬 사용 횟수를 출력해줘"라고 클로드 코드에 입력하면, 내가 가진 스킬들이 각각 몇 번 호출됐는지 확인할 수 있습니다. 이 중에서 쓰지 않는 스킬들은 과감히 정리하는 것이 좋습니다.

토큰이 낭비됩니다. 클로드 코드를 실행할 때 쓰지 않는 스킬까지 전부 컨텍스트에 포함되기 때문입니다.
비슷한 스킬이 여러 개 있으면 AI가 어떤 걸 써야 할지 혼동합니다. 예를 들어 제가 "코드베이스를 파악해줘"라고 입력했을 때, 익스플로어(Explore)라는 기본 스킬도 있고 제가 따로 만든 '코드베이스 분석'이라는 스킬도 있다면, 클로드는 둘 중 어떤 걸 써야 할지 매번 다른 선택을 할 수 있습니다. 어떤 날은 익스플로어로, 어떤 날은 제가 만든 스킬로요. 그러면 같은 프롬프트를 넣어도 결과 품질이 매번 달라질 수 있습니다.

그러므로 쓰지 않는 스킬들은 자주 정리하는 것이 좋습니다.

<클로드 코드 길들이기: 6인의 실제 사례> 전자책(PDF) 출시!

실무자 6인의 클로드 코드 실전 활용법을 엮은 <클로드 코드 길들이기: 6인의 실제 사례> 전자책(PDF) 출시!

스타트업 CTO, 프리랜서 개발자, 1인 빌더, 비개발자 대기업 PM, AX 기획자, BizOps 리드까지.
개발자 3인 + 비개발자 3인이 시행착오 끝에 발견한
클로드 코드 실전 길들이기 사례를 한 권에 담았습니다.

지금 읽고 있는 글의 전체 내용은
<클로드 코드 길들이기: 6인의 실제 사례>에서 확인하실 수 있습니다.

이런 분께 추천합니다

# 클로드 코드 좋다는데,

정작 내 업무엔 어떻게 적용할지 감이 안 잡히는 분

# 개발자, PM, 기획자 등 다양한 직군의

실무 활용 사례를 한번에 보고 싶은 분

# 남들은 어떻게 쓰는지 시행착오까지

솔직한 후기가 필요한 분

# CLAUDE.md, 스킬, 하네스 같은

용어는 아는데 실전 감이 안 잡히는 분

# 코딩 경험 없이도 클로드 코드로

직접 서비스를 만들고 배포까지 해보고 싶은 분