Agent Skills 사용 방법

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

그리고 가장 좋은 점은?

기업들이 이런 스킬을 직접 만들어주기 때문에, 사용자는 워크플로우에 바로 적용하기만 하면 됩니다. 이 가이드에서는 이런 스킬을 활용해 실제로 동작하는 기능을 만드는 방법을 알려드릴게요.실제로 효과가 있는 기능입니다.

Skills란?

“Skill”은 특정 작업을 수행하는 방법에 대한 마크다운 파일이 들어 있는 폴더입니다. 메인 스킬 파일의 이름은 반드시 SKILL.md이어야 하며, 이 파일의 내용은 원하는 대로 작성할 수 있지만, 프론트매터에 name과 description 필드는 반드시 포함되어야 합니다. (추가로 사용할 수 있는 선택적 프론트매터 필드는 여기에서 확인할 수 있습니다.)

이 메인 SKILL.md 파일은 500줄 이하로 작성하는 것을 권장합니다.

이 폴더 안에는 다른 정보들도 포함할 수 있으며, SKILL.md 파일에서 참조할 수 있지만, 실제로 필요한 경우에만 컨텍스트에 불러옵니다. 이 정보들은 다음 폴더에 저장하는 것이 좋습니다:

1. scripts/ - 에이전트가 실행할 수 있는 코드
2. references/ - 필요할 때 추가 문서로 사용할 수 있는 마크다운 파일
3. assets/ - 에이전트가 사용할 수 있는 정적 리소스

Skills의 특별함은?

AI를 사용할 때 가장 큰 문제 중 하나는 컨텍스트 과부하입니다.컨텍스트 과부하는 AI에게 너무 많은 정보(즉, 컨텍스트)를 제공해서 오히려 작업 수행이 어려워지는 현상입니다.

예를 들어, 주니어 개발자에게 특정 기능에 대한 정확한 문서만 제공하면, 그 문서를 읽고 해당 기능을 구현할 성공 확률이 높아집니다.

반대로, 주니어 개발자에게 모든 문서를 다 읽으라고 한 뒤, 그 중 일부만 참고해서 특정 기능을 구현하라고 하면 성공 확률이 훨씬 낮아집니다.

LLM도 마찬가지로 동작합니다.

초기 방식인 MCP 등은 많은 양의 구조화된 컨텍스트를 모델에 불러와서 문제를 해결하려 했습니다. 이 방식이 아예 없는 것보다는 나았지만, 여전히 일관되게 작업을 수행하는 데에는 한계가 있었습니다.

Skills는 다릅니다.

기본적으로 프론트매터의 name과 description만 컨텍스트 윈도우에 불러옵니다. 이로 인해 컨텍스트를 거의 차지하지 않으면서도, LLM에게 어떤 스킬이 있는지 정보를 제공합니다. 특정 Skill이 필요하다고 판단되면 SKILL.md 파일이 컨텍스트 윈도우에 불러와집니다. 그리고 정말 필요할 때만 scripts/, references/, assets/ 폴더의 다른 파일들이 추가로 불러와집니다.

그렇다면, 이런 Skills는 어떻게 사용할까요?

skills.sh

사용하는 LLM 인터페이스에 따라, Skills를 다운로드해서 해당 애플리케이션에 맞는 위치에 저장하면 됩니다. 예를 들어:

Skills는 단순히 파일이 들어 있는 폴더이기 때문에, 복사해서 해당 디렉터리에 붙여넣기만 해도 바로 사용할 수 있습니다.

또 다른 방법은 skills.sh. 

이것은 Vercel에서 만든 Agent Skills 디렉터리로, 얼마나 자주 사용되는지에 따라 Skills를 찾아볼 수 있습니다. 또한, 이들이 개발한 CLI 도구를 사용해 프로젝트나 전체 사용자에 Skills를 추가할 수 있습니다.

이렇게 하려면 다음 명령어를 실행하세요:npx skills add <owner/repo>이 명령어가 전체 과정을 안내해줍니다. 사실상 복사-붙여넣기와 같지만 더 빠릅니다.

Skills 사용하기

설치가 끝나면 (skills.sh 또는 복사-붙여넣기 방식 모두), 사용 방법은 매우 간단합니다. 어떤 에디터를 사용하든 자동으로 필요하다고 판단되면 해당 스킬을 사용합니다. 이론적으로는, 올바른 위치에 스킬을 불러오면 더 이상 신경 쓸 필요가 없습니다.

하지만, 이 글을 작성하는 시점에서는 항상 적절한 순간에 Skills를 활용하지는 않습니다. 만약 특정 순간에 Skill을 사용해야 한다고 생각된다면, LLM에게 직접 알려주세요.

예를 들어, ElevenLabs의 음성-텍스트 변환 스킬을 설치한 뒤, Claude에게 사용하도록 하려면 다음과 같이 프롬프트를 보낼 수 있습니다:

이 프로젝트에서 간단한 예제를 구현할 때 음성-텍스트 변환 스킬을 사용하세요. 오디오로는 이것을 사용하세요.https://storage.googleapis.com/eleven-public-cdn/audio/marketing/nicole.mp3.

아래 앱을 한 번에 완성할 수 있었습니다.

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

프로젝트에서 Agent Skills를 적극적으로 활용해보세요. 처음 도구를 만든 사람들이 직접 선별한 적절한 컨텍스트를 LLM에 제공할 수 있습니다.

그리고 프로젝트에서 ElevenLabs를 사용한다면, 아래 명령어로 저희 스킬을 설치해보세요:

npx skills add elevenlabs/skills