Agent Skills 사용 방법

Agent Skills는 LLM을 활용하는 가장 효과적인 방법 중 하나입니다. 반복적으로 수행할 작업에 적합한 컨텍스트를 제공합니다. 

가장 좋은 점은 무엇일까요? 

기업들이 이러한 스킬을 만들어 두므로, 워크플로에 활용하기만 하면 됩니다. 이 가이드에서는 이러한 스킬을 활용해 기능을 실제로 작동하도록 만드는 방법을 알려드리겠습니다.

스킬이란 무엇인가요?

‘스킬’은 특정 작업을 수행하는 방법을 담은 마크다운 파일 폴더입니다. 기본 스킬 파일의 이름은 반드시 SKILL.md이어야 하며, 프런트매터에 이름과 설명 필드가 포함되어 있다면 파일 내용은 원하는 대로 작성할 수 있습니다. (그 밖에도 여기에서 확인할 수 있는 선택적 프런트매터 필드가 있습니다.)

이 폴더에는 SKILL.md 파일에서 참조할 수 있지만 필요할 때만 컨텍스트에 로드되는 다른 정보를 포함할 수 있습니다. 이 정보는 다음 폴더에 저장해야 합니다.

1. scripts/ - 에이전트가 실행할 수 있는 코드입니다.
2. references/ - 필요할 때 추가 문서로 사용할 수 있는 마크다운 파일입니다.
3. 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에서 이를 사용하고 싶다면 다음 프롬프트를 보낼 수 있습니다.

아래 앱을 한 번의 프롬프트만으로 만들 수 있었습니다.

물론 이 UI는 많은 개선이 필요하지만, 핵심 ElevenLabs 로직은 제대로 작동합니다. 문장 하나만으로 가능했습니다. 

프로젝트에서 Agent Skills를 적극 활용해 보시기를 권장합니다. 처음부터 도구를 만든 사람들이 선별한 특정 작업에 적합한 컨텍스트를 LLM에 제공할 수 있습니다.

프로젝트에서 ElevenLabs를 사용 중이라면 다음 명령으로 ElevenLabs 스킬을 설치하세요:

npx skills add elevenlabs/skills