Skill (Claude Code Skill)

지침을 다시 사용할 수 있게 묶는다

Claude Code의 공식 Skill 문서는 지침과 참고 자료를 필요한 작업에 사용할 수 있게 구성하는 방법을 설명합니다. 절차, 도메인 지식, 예시, 실행 스크립트 등을 함께 둘 수 있습니다.

Skill 자체는 결과의 정확성을 보장하는 실행기가 아닙니다. 에이전트가 지침을 읽고 도구와 함께 수행하므로, 같은 파일을 써도 입력·모델·환경에 따라 결과가 달라질 수 있습니다.

BOAZ가 Skill에 남기는 것

회의록을 정리하는 일을 예로 들면 ‘요약하고 저장하라’는 순서만으로는 충분하지 않을 수 있습니다. 결정과 제안을 어떻게 나눌지, 담당자가 없으면 추측할지 확인 필요로 남길지 같은 판단이 결과의 품질을 바꿉니다.

모든 업무에 긴 지침이 필요한 것은 아닙니다. 이미 잘하는 동작을 세세하게 반복하기보다 원하는 결과에 영향을 주는 조건을 남깁니다.

실제 작업에서 기준을 추출한다

처음부터 완성된 매뉴얼을 가정하기보다, 업무를 수행하고 결과를 고치는 과정에서 재사용할 기준을 찾습니다. 사용자가 왜 수정했는지, 어떤 문장은 유지했고 어떤 판단을 바꿨는지 확인합니다.

BOAZ가 Skill을 만드는 방식을 정리한 최근 메모에서도 원하는 수준의 결과를 만드는 최소한의 지침을 강조했습니다. 대화 전체를 복사하는 것보다 만족스러운 결과를 만든 기준을 추리는 것이 핵심입니다.

그다음 다른 입력으로 재실행합니다. 첫 결과만 잘 나온 것인지, 새 상황에서도 같은 기준을 적용하는지 확인해야 합니다. 이 과정은 검증 Loop와 이어집니다.

암묵지는 정상 사례와 경계 사례로 꺼낸다

‘이 정도면 적절히 정리됐다’는 판단을 그대로 적으면 다음 실행에서도 모호합니다. 가상 회의록 두 개를 비교하며 무엇을 결정으로 보고 무엇을 제안으로 남겼는지, 어떤 경우에 담당자 확인을 요청했는지 설명합니다.

예를 들어 ‘담당자가 언급되지 않았으면 추측해 채우지 않고 확인 필요로 표시한다’처럼 관찰 가능한 기준으로 바꿀 수 있습니다. 정상 사례뿐 아니라 기준이 적용되지 않는 예외도 함께 남깁니다.

이렇게 꺼낸 암묵지는 AI 자산화의 재료입니다. 새 회의록에도 같은 판단이 통하는지 검증하고, 개인의 문체 선호와 조직이 지켜야 하는 사실 처리 기준을 구분합니다.

회사 지식과 수행 절차를 나눈다

온톨로지와 위키는 회사의 대상·관계·사실을 정리할 수 있습니다. Skill은 그 지식을 참고해 업무를 처리하는 방법을 안내합니다.

예를 들어 프로그램 대상이 바뀌면 지식 원천을 고치고, 소개문이 제안과 확정을 섞어 쓰면 작성 절차와 검증 기준을 고칩니다. 둘 다 바뀌었다면 둘 다 수정합니다. 지식 갱신을 Skill 수정 하나로 대신할 수는 없습니다.

Skill과 에이전트는 조합한다

Skill은 지침과 재료이고 에이전트는 실행 주체입니다. Skill이 쌓여야만 에이전트가 되는 고정 단계는 아닙니다. 서브에이전트에 Skill을 제공하거나, 필요에 따라 별도 맥락에서 실행하는 구성도 가능합니다.

팀 공유가 필요하면 플러그인으로 묶을 수 있습니다. 배포 후에는 실제 적용 버전과 결과를 확인하고 실패가 다음 수정으로 이어지도록 담당자를 정합니다.