스킬은 에이전트에서 가장 많이 사용되는 확장 포인트 중 하나입니다.
유연하고 만들기도 쉬우며, 배포하기도 간편한 스킬을 제대로 활용하세요.
각 팁을 클릭하면 해당 섹션으로 바로 이동합니다.
스킬은 SKILL.md 파일과 (선택 사항인) 몇 가지 보조 파일들이 담긴 폴더입니다. 에이전트에서 가장 많이 사용되는 확장 포인트 중 하나로, 유연하고 만들기도 쉬우며 배포하기도 간편합니다.
SKILL.md의 설명(Description)은 스킬을 작동시키는 '트리거'입니다. 설명이 모호하면 에이전트가 언제 스킬을 활성화해야 할지 알 수 없고, 너무 광범위하면 모든 요청에 스킬이 실행되어 버립니다.
에이전트는 똑똑합니다. 여러분의 역할은 에이전트가 '아직 모르는 것'을 알려주는 것입니다. 연구에 따르면 문맥이 너무 많은 길고 포괄적인 지침은 오히려 성능을 저하시킵니다.
interactions.create()를 사용하세요라고 하세요. 전자는 단순한 정보일 뿐이지만, 후자는 에이전트가 수행해야 할 지침입니다.모든 내용을 하나의 파일에 몰아넣지 마세요. 에이전트는 정보를 레이어별로 로드합니다. 3단계 로딩 구조를 활용해 컨텍스트 공간을 효율적으로 관리하세요.
만약 스킬이 여러 주제(예: AWS 배포와 GCP 배포)를 다룬다면, 이를 별도의 참조 파일로 분리하세요. 에이전트는 필요한 것만 읽게 되어, 실제 작업을 위한 컨텍스트 공간을 아낄 수 있습니다.
흔히 하는 실수는 스킬을 단계별 워크플로우로 만드는 것입니다. 모든 단계를 강요하면 에이전트가 스스로 적응하거나, 오류를 복구하거나, 더 나은 방법을 찾을 기회를 박탈하게 됩니다. 경로가 아니라 결과를 설명하세요.
스킬이 실행되지 말아야 할 때가 언제인지 생각하세요. "모든 코딩 작업에 사용"과 같은 설명은 모든 요청을 가로채 버릴 수 있습니다.
'트리거되어야 하는 경우'와 '트리거되지 말아야 하는 경우'를 모두 테스트하는 것이 필수적입니다. 그렇지 않으면 스킬이 한쪽으로만 치우치게 됩니다.
평가(Evaluation) 없이 스킬을 배포하지 마세요. 에이전트는 실행할 때마다 다르게 동작할 수 있으므로 한 번의 확인으로는 부족합니다.
스킬 없이 평가를 진행해 보세요. 스킬 없이도 테스트를 통과한다면, 모델이 이미 그 스킬의 가치를 흡수한 것이므로 해당 스킬은 더 이상 필요하지 않습니다. 이제 폐기(Retire)하세요. 특히 모델이 발전함에 따라 역량(Capability) 스킬에서 이런 경우가 자주 발생합니다.