[한영자막] 당신은 에이전트 스킬을 제대로 사용하지 못하고 있습니다

한 줄 핵심

에이전트 스킬은 단순한 skill.md가 아니라 컨텍스트·지식·워크플로·도구 실행을 묶는 재사용 가능한 장치이며, 자주 반복되는 요구를 스킬로 분리하고 전역 설정과 프로젝트 설정을 엄격히 나눠야 효과가 커진다.

시간별 요약

1. 0:00
   에이전트 스킬은 결국 에이전트에 주입되는 추가 컨텍스트이지만, 단순한 한 장짜리 파일이 아니라 참조 자료와 에셋, 스크립트까지 포함하는 구조로 쓸 수 있다. 특히 설명 메타데이터만 먼저 로드하고 필요할 때만 본문을 여는 방식이 핵심이다.
2. 2:01
   이미지 생성 같은 작업은 결정적 처리와 비결정적 프롬프트 설계를 분리하면 가장 효율적이다. 스크립트는 요청 전송·응답 처리·저장을 맡고, 스킬은 애매한 요구를 적절한 프롬프트로 바꿔 스크립트를 호출하게 만든다.
3. 4:00
   스킬의 첫 번째 용도는 지식 격차를 메우는 것이다. effect library처럼 모델이 충분히 잘 모르는 도메인은 문서 조사와 선별된 URL을 바탕으로 지식을 정리해 스킬로 만들어 두면, 매번 외부 문서를 다시 찾지 않아도 된다.
4. 6:01
   스킬의 두 번째 용도는 실행 격차를 메우는 것이다. 계획 작성, 리뷰, 복잡도 판단, 서브에이전트 분리 같은 작업 규칙을 스킬에 넣으면 에이전트가 더 일관된 구조로 움직이고, 메인 컨텍스트도 덜 오염된다.
5. 10:01
   스킬은 짧고 선명하게 유지해야 하며, 자주 반복되는 요구나 반복되는 오류만 스킬로 승격하는 것이 좋다. 또한 스킬은 고정된 자산이 아니라 모델 변화, 도구 변화, 작업 방식 변화에 맞춰 계속 개선하거나 폐기해야 한다.

실무 인사이트

• 반복적으로 같은 지시를 하거나 같은 실수를 고친다면 그 규칙은 프롬프트가 아니라 스킬로 빼서 재사용성을 높이는 것이 좋다.
• 전역 스킬은 누구나 쓰는 공통 도구 수준으로만 유지하고, 도메인 지식은 프로젝트별 스킬로 넣어 컨텍스트 낭비와 성능 저하를 줄여야 한다.
• 항상 지켜야 하는 하드 규칙은 스킬이 아니라 agents.md나 Claude.md에 두어 활성화 누락 가능성을 없애는 편이 낫다.