Agent Skills 사용 방법
- 작성자
- Tadas Petra
- 게시일
- 최종 업데이트
Agent Skills는 LLM을 활용하는 가장 효과적인 방법 중 하나입니다. 반복적으로 수행할 작업에 알맞은 컨텍스트를 제공합니다.
가장 좋은 점은 무엇일까요?
기업들이 이러한 스킬을 만들어 주므로 워크플로에 활용하기만 하면 됩니다. 이 가이드에서는 이러한 스킬을 활용해 실제로 작동하는 기능을 만드는 방법을 보여드리겠습니다.
스킬이란 무엇인가요?
‘스킬(Skill)’은 특정 작업을 수행하는 방법을 담은 마크다운 파일 폴더입니다. 기본 스킬 파일의 이름은 반드시 SKILL.md이어야 하며, 프론트매터에 이름과 설명 필드가 포함되어 있다면 파일 내용은 자유롭게 작성할 수 있습니다. (그 밖에도 여기에서 확인할 수 있는 선택적 프론트매터 필드가 있습니다.)
기본 SKILL.md 파일은 500줄 미만으로 유지하는 것이 좋습니다.
이 폴더에는 SKILL.md 파일에서 참조할 수 있지만 필요할 때만 컨텍스트에 로드되는 다른 정보도 포함할 수 있습니다. 이 정보는 다음 폴더에 저장해야 합니다:
- scripts/ - 에이전트가 실행할 수 있는 코드입니다.
- references/ - 필요할 때 추가 문서로 사용할 수 있는 마크다운 파일입니다.
- assets/ - 에이전트가 사용할 수 있는 정적 리소스입니다.
스킬의 특별한 점은 무엇인가요?
AI 사용 시 가장 큰 문제 중 하나는 컨텍스트 비대화입니다. 컨텍스트 비대화란 AI에 너무 많은 컨텍스트, 즉 정보를 제공해 작업 수행이 어려워지는 현상입니다.
주니어 개발자에게 특정 기능에 관한 정확한 문서만 제공하고 관련 없는 정보는 전혀 주지 않는 상황을 상상해 보세요. 이 문서를 읽은 뒤에는 해당 기능을 구현할 가능성이 높습니다.
이제 주니어 개발자에게 모든 문서를 읽으라고 요청하는 상황을 상상해 보세요. 그리고 읽은 뒤, 문서의 작은 일부에 있는 특정 기능을 구현하라고 합니다. 성공률은 훨씬 낮아질 것입니다.
LLM도 똑같이 작동합니다.
이전의 MCP와 같은 접근 방식은 대량의 구조화된 컨텍스트를 모델에 로드해 이 문제를 해결하려 했습니다. 아무것도 없는 것보다는 효과적이었지만, 여전히 작업을 일관되게 수행하는 데 어려움이 있었습니다.
스킬은 다릅니다.
기본적으로 프론트매터의 이름과 설명만 컨텍스트 윈도우에 로드됩니다. 컨텍스트 사용량은 매우 적지만, LLM에 어떤 종류의 스킬을 사용할 수 있는지 알려 줍니다. 스킬이 유용하다고 판단되면 SKILL.md가 컨텍스트 윈도우에 로드됩니다. 이후 필요할 때만 scripts/, references/, assets/ 폴더의 다른 파일이 컨텍스트에 로드됩니다.
그렇다면 이 스킬은 어떻게 사용할까요?
skills.sh
사용 중인 LLM 인터페이스에 따라 해당 애플리케이션에 맞는 위치에 다운로드하여 저장할 수 있습니다. 예를 들면 다음과 같습니다:
다시 말해 스킬은 파일이 담긴 폴더일 뿐이므로, 이 디렉터리에 복사해 붙여넣으면 모두 작동합니다.
다른 방법은 skills.sh를 사용하는 것입니다.
Vercel이 만든 Agent Skills 디렉터리로, 사용 빈도를 기준으로 스킬을 찾을 수 있습니다. Vercel이 개발한 CLI 도구를 사용해 이러한 스킬을 프로젝트나 전역 사용자 환경에 추가할 수도 있습니다.
이렇게 하려면 npx skills add <owner/repo> 명령어를 실행하세요. 전체 과정을 안내해 줍니다. 이 명령어는 사실상 복사 및 붙여넣기 기능이지만 더 빠릅니다.
스킬 사용하기
스킬을 설치했다면(skills.sh 또는 복사 및 붙여넣기 방식) 사용 방법은 매우 간단합니다. 사용하는 에디터는 유용하다고 판단할 때마다 스킬을 자동으로 사용해야 합니다. 이론적으로는 스킬을 올바른 위치에 로드하면 더 이상 신경 쓸 필요가 없습니다.
하지만 이 글을 작성하는 현재 시점에는 항상 적절한 순간에 스킬을 활용하지는 않습니다. 따라서 특정 순간에 스킬을 사용해야 한다는 것을 알고 있다면 LLM에 알려 주세요.
예를 들어, ElevenLabs의 음성 텍스트 변환 스킬을 설치했습니다. Claude가 이를 사용하게 하려면 다음 프롬프트를 보낼 수 있습니다:
이 프로젝트에서 간단한 예제를 구현하려면 speech to text 스킬을 사용하세요. 오디오는 https://storage.googleapis.com/eleven-public-cdn/audio/marketing/nicole.mp3를 사용하세요.
아래 앱을 한 번에 구현할 수 있었습니다.
물론 이 UI는 크게 개선해야 하지만, ElevenLabs의 핵심 로직은 탄탄하게 작동합니다. 단 한 문장만으로 가능했습니다.
프로젝트에서 Agent Skills를 적극적으로 활용해 보시기를 권장합니다. 도구를 처음 만든 사람들이 선별한, 특정 작업에 알맞은 컨텍스트를 LLM에 제공할 수 있습니다.
프로젝트에서 ElevenLabs를 사용하고 있다면 다음 명령어로 스킬을 설치하세요:
