[한영자막] 좋은 Agent Skill을 만드는 방법

한 줄 핵심

좋은 Agent Skill은 트리거·구조·스티어링·프루닝을 체계적으로 설계해 컨텍스트 부담과 불확실성을 줄여야 하며, 특히 짧고 분기별로 정리된 skill.md와 강한 leading words가 성능을 크게 좌우한다.

시간별 요약

1. 0:00
   이 영상은 Agent Skill을 잘 쓰지 못해 생기는 ‘skill hell’을 문제로 제기하며, 좋은 skill과 나쁜 skill을 가르는 공통 기준이 없다는 점을 지적한다. 이를 해결하기 위해 트리거, 내부 구조, 스티어링, 프루닝이라는 4가지 체크리스트를 제시한다.
2. 3:00
   첫 번째 핵심은 skill의 호출 방식이며, user invoked와 model invoked를 구분해 설계해야 한다. model invoked는 유연하지만 컨텍스트 로드와 불확실성을 늘리고, user invoked는 사용자의 인지 부담은 커지지만 에이전트 쪽 컨텍스트를 더 작고 예측 가능하게 유지한다.
3. 8:00
   skill 내부 구조는 steps와 reference라는 두 단위로 나누어 생각하는 것이 효과적이다. 또한 모든 내용을 skill.md에 넣기보다 분기별로 필요한 reference만 context pointer 뒤에 숨겨 skill.md를 최대한 작게 유지해야 유지보수와 토큰 비용 모두에 유리하다.
4. 12:01
   스티어링의 핵심은 leading words를 일관되게 써서 에이전트의 행동을 원하는 방향으로 압축하는 것이다. ‘vertical slice’처럼 의미가 강한 짧은 표현을 반복해 코드 작성 방식을 유도하고, 한 단계에 더 많은 legwork가 필요하면 future step을 숨겨 별도 skill로 분리한다.
5. 17:00
   프루닝 단계에서는 massive skill의 원인을 찾기 위해 중복, sediment, no-op을 제거해야 한다. 각 정보의 단일 출처를 유지하고, 분기와 무관한 오래된 문장은 삭제하며, 실제로 에이전트 행동을 바꾸지 않는 문단은 deletion test로 과감히 없애야 한다.

실무 인사이트

• 새 skill을 만들 때는 먼저 trigger를 정하고, 다음에 steps와 reference를 분리한 뒤, 마지막에 pruning으로 중복과 no-op을 제거하는 순서가 가장 실무적이다.
• 컨텍스트를 아끼려면 ‘모든 것을 넣는 skill’보다 ‘필요할 때만 불러오는 reference’를 늘리는 편이 더 안정적이며, 특히 branching이 많은 skill에서 효과가 크다.
• 에이전트가 기대만큼 움직이지 않을 때는 설명을 길게 늘리기보다 leading words를 강화하거나 step을 분리해 다음 목표를 숨기는 방식이 더 잘 먹힌다.