AI agent skill은 단순히 좋은 프롬프트를 저장해두는 기능으로 보면 금방 한계가 옵니다. 반복 업무에서 필요한 것은 문장 하나가 아니라, 언제 어떤 절차를 쓰고 어떤 결과를 검증할지까지 포함한 작업 단위입니다.
이 글에서는 AI agent skill을 프롬프트 조각이 아니라 재사용 가능한 작업 단위로 봅니다. Claude Code의 Skills 문서도 skill을 특정 작업을 더 잘 수행하도록 지식과 절차를 담는 방식으로 설명합니다.
AI agent skill을 구성하는 4가지
프롬프트 조각과 skill은 무엇이 다를까
프롬프트 조각은 보통 특정 문장이나 지시문입니다. 예를 들어 “친절하게 설명해줘” 또는 “표로 정리해줘” 같은 식입니다. 반면 skill은 특정 작업을 끝내기 위한 절차, 참조 자료, 검증 기준을 함께 담습니다.
예를 들어 블로그 글 검토 skill이라면 단순히 “글을 검토해줘”가 아니라 제목, 사실성, 출처, 코드 예시, WordPress 포맷, Yoast 관점까지 확인하는 순서를 포함해야 합니다.
skill이 필요한 순간
- 같은 작업을 여러 번 반복한다.
- 작업 순서가 빠지면 품질이 흔들린다.
- 참고해야 할 규칙 파일이나 템플릿이 있다.
- 도구 호출 순서가 중요하다.
- 결과 검증 기준이 명확해야 한다.
좋은 skill은 trigger가 분명하다
skill은 언제 써야 하는지부터 분명해야 합니다. 모든 요청에 항상 켜지는 지시가 아니라, 특정 작업에서만 활성화되는 작업 도구에 가까워야 합니다.
skill:
name: draft_review
use_when:
- WordPress draft를 만들기 전
- article_package.json을 검증할 때
do:
- factpack과 본문 주장 비교
- 코드블럭 형식 확인
- 내부 링크와 외부 출처 확인
- publish 승인 여부 확인trigger가 흐리면 skill은 모든 작업에 끼어들어 오히려 방해가 됩니다. 반대로 trigger가 좁고 분명하면 에이전트가 필요한 순간에만 적절한 절차를 꺼낼 수 있습니다.
skill은 도구 사용법도 포함할 수 있다
실무 자동화에서는 어떤 도구를 어떤 순서로 쓰는지가 중요합니다. 검색, 파일 읽기, 테스트, 배포, WordPress draft 생성처럼 순서가 바뀌면 문제가 생기는 작업은 skill에 도구 사용 흐름까지 들어가야 합니다.
이 지점은 Agent workflow 글과 연결됩니다. workflow가 실행 흐름을 나눈다면, skill은 특정 작업을 반복 가능하게 만드는 작은 절차 단위입니다.
나쁜 skill의 신호
- 너무 넓어서 언제 쓰는지 애매하다.
- 좋은 말만 있고 실제 절차가 없다.
- 출력 기준이 없어 결과 품질을 판단하기 어렵다.
- 도구 사용 권한과 위험도를 구분하지 않는다.
- 오래된 규칙을 계속 강제한다.
설계 체크리스트
- 이 skill은 어떤 요청에서만 켜져야 하는가?
- 작업을 끝내는 순서가 단계로 적혀 있는가?
- 필요한 참조 파일, 템플릿, 예시가 있는가?
- 결과를 검증하는 기준이 있는가?
- 위험한 도구 호출은 승인 흐름을 거치게 했는가?
정리
AI agent skill은 프롬프트 조각을 모아둔 폴더가 아닙니다. 반복 작업을 안정적으로 수행하기 위한 trigger, 절차, 리소스, 도구 사용법, 검증 기준의 묶음입니다. skill을 이렇게 설계하면 에이전트가 매번 처음부터 생각하지 않고도 일관된 품질로 작업을 수행할 수 있습니다.
