Agent Skills (에이전트 스킬)
용도별 프롬프트·절차·도구 묶음을 패키지화해 에이전트가 '기능' 처럼 호출하게 만드는 구조. Claude Code 가 선행 구현.
1줄 정의
용도별 프롬프트·절차·도구 묶음을 패키지화해 에이전트가 ‘기능’ 처럼 호출하게 만드는 구조. Claude Code 가 선행 구현.
전체 시스템에서 맡는 역할
큰 agent 는 여러 태스크를 할 수 있지만 특정 태스크를 반복해서 높은 품질로 돌리고 싶을 때 곤란해진다. “매번 긴 프롬프트 쓰기”, “과거 프롬프트 복붙” 은 운영으로 지속 불가능.
Agent Skills 는 특정 용도의 작업 절차를 하나의 ‘스킬’ 로 저장해 필요할 때 불러 쓸 수 있게 만드는 구조. Claude Code 가 Skills 기능으로 먼저 구현했다.
하나의 Skill 은 전형적으로 이걸 담는다.
- 목적과 대상 태스크 기술
- 참조할 문서 / 템플릿
- 써야 할 도구 목록
- 지킬 절차 / 체크리스트
- 출력 포맷
사용자가 /{skill-name} 으로 부르면 에이전트가 그 절차대로 작업한다. 사람이 쓴 “SOP (표준 운영 절차) 를 agent 화한 것” 으로 읽는 게 가장 가깝다.
harness 의 일부로 보면 Skills 는 사용자 확장 지점이다. 본체 harness 는 안 바꾸고, 특정 용도 거동을 덧붙일 수 있다.
흔한 오해
- 오해 1: Skills 는 긴 프롬프트 모음이다, 라고 여겨지기 쉽다.
– 실제로 프롬프트뿐 아니라 도구 선정, 참조 파일, 절차, 평가 기준까지 패키지화한다. 정적 텍스트보다 한 단계 넓은 개념.
- 오해 2: Skills 를 늘리면 agent 가 똑똑해진다, 라고 기대되기 쉽다.
– 실제로 Skills 는 “특정 태스크에서 고품질로 돌리기” 용이다. 관계 없는 태스크까지 Skill 화해서 로드하면 오히려 본체 판단을 흐리게 한다. 용도 입자 설계가 승부.
이 용어가 중요한 이유
Skills 를 설계 단위로 다룰 수 있으면 조직의 업무 절차를 에이전트에 상속시킬 수 있다.
- 새로운 계약서 리뷰 절차 → Skill 화
- 특정 스타일 기사 집필 → Skill 화
- 배포 전 체크리스트 → Skill 화
사람에게 외우게 하는 대신 Skill 로 저장하면 누가 불러도 같은 품질로 돈다.
이 용어가 나오는 기사
- Claude Code, 하네스 엔지니어링 관련 기사
다음에 읽을 용어 3개
- Claude Code — Skills 의 대표 구현.
- harness — Skills 가 들어가는 상위층.
- agent — Skills 를 쓰는 주체.