에이전트 스킬이란? 예시와 시작 가이드

에이전트 스킬은 AI 에이전트가 특정 작업을 수행하도록 안내하는 재사용 가능한 지침 패키지로, 필요에 따라 스크립트, 참고 자료, 템플릿을 포함할 수 있습니다. 개방형 Agent Skills 형식에서 각 패키지는 SKILL.md 파일을 중심으로 구성된 폴더입니다. 호환되는 에이전트는 관련 상황에서 스킬을 찾아 지침을 불러올 수 있으므로, 모든 절차를 한 번에 대화에 담아 둘 필요가 없습니다. 이 가이드에서는 형식을 설명하고, 실용적인 예시를 보여 주며, 첫 번째 스킬을 만들고 테스트하는 방법을 안내합니다.

Agent Skills는 전문 지식과 워크플로를 패키징하기 위한 가볍고 개방적인 형식입니다. 스킬에는 이름과 용도를 설명하는 YAML 프론트매터와 그 뒤에 이어지는 Markdown 지침이 포함된 SKILL.md 파일이 들어 있습니다. 보조 파일로는 스크립트, 참고 문서, 템플릿 등을 포함할 수 있습니다.

“AI 스킬”이라는 말은 사람이 AI를 활용하는 능력 등 여러 의미를 가리킬 수 있습니다. 이 가이드에서 에이전트 스킬과 AI 에이전트 스킬은 호환되는 에이전트에서 사용하는 재사용 가능한 SKILL.md 패키지를 구체적으로 의미합니다.

예를 들어 회의 요약 스킬은 팀 회의록의 섹션 구성, 의사 결정 기록 방법, 담당자나 마감일이 누락된 항목을 표시하는 방법을 정의할 수 있습니다. 이러한 규칙을 한 번 저장해 두면 새 회의 메모에도 재사용할 수 있습니다. 스킬은 에이전트의 작업을 안내할 뿐, 기반 모델을 재학습시키지는 않습니다.

개방형 사양에서는 프론트매터에 name과 description을 반드시 포함하도록 요구합니다. name은 164자여야 하며, 소문자, 숫자, 하이픈을 사용하고 디렉터리 이름과 일치해야 합니다. 또한 하이픈으로 시작하거나 끝날 수 없고, 연속된 하이픈을 포함할 수 없습니다. description은 11,024자여야 하며, 작업 내용과 스킬을 사용해야 하는 시점을 모두 설명해야 합니다.

이 형식은 점진적 공개를 위해 설계되었습니다. 에이전트는 전체 지침을 불러오기 전에 스킬을 선택하는 데 필요한 충분한 정보를 받습니다.

1. 탐색. 에이전트는 사용 가능한 스킬의 이름과 설명을 받습니다. 이 메타데이터도 컨텍스트를 사용하지만, 전체 절차를 처음부터 모두 불러오지는 않습니다.

2. 활성화. 에이전트가 관련 스킬을 선택하면 SKILL.md를 읽습니다. 일부 도구에서는 이름으로 스킬을 호출하거나 자동 선택을 비활성화할 수도 있습니다.

3. 실행. 에이전트는 절차를 따르며, 필요하고 허용된 경우 보조 참고 자료를 읽거나 스크립트를 실행합니다.

이렇게 하면 비활성 절차가 사용하는 컨텍스트를 줄일 수 있습니다. 실제 컨텍스트 사용량은 설명의 수와 길이, 활성 스킬, 불러온 리소스에 따라 달라집니다. 명확한 설명은 선택에 도움이 되지만, 활성화와 출력 품질은 여전히 테스트가 필요합니다.

AI 도구 관련 용어는 복잡하며, "스킬"은 비슷해 보이는 여러 개념과 함께 사용됩니다. 차이점은 다음과 같습니다.

스킬과 프롬프트. 프롬프트는 대화 안에서 지침을 제공하는 반면, 스킬은 탐색 또는 명시적 호출을 위해 재사용 가능한 절차와 보조 리소스를 저장합니다. 프롬프트도 저장하여 재사용할 수 있습니다. 반복 작업에 유지 관리되는 워크플로, 예시, 참고 자료 또는 스크립트가 필요할 때 스킬이 유용해집니다.

스킬과 MCP. MCP는 에이전트에 기능, 즉 실시간 도구 및 데이터에 연결할 수 있는 수단을 제공합니다. 스킬은 에이전트에 지식, 즉 작업을 잘 수행하는 방법과 순서, 검증 단계를 제공합니다. 두 가지는 상호 보완적입니다. 코드 검토 스킬은 철저한 검토의 기준을 정의하고, GitHub MCP 서버는 에이전트가 실제 풀 리퀘스트를 읽을 수 있게 합니다.

스킬과 프로젝트 지침. AGENTS.md 같은 파일은 에이전트의 로딩 및 범위 규칙에 따라 프로젝트 지침을 제공합니다. 폭넓게 적용되는 규칙은 해당 파일에 두고, 관련 시 불러와야 하는 작업별 절차에는 스킬을 사용하세요. 정확한 동작 방식은 도구에 따라 다릅니다.

• 재사용 가능한 전문성: 매번 설명할 필요 없이 작업별 방법, 체크리스트, 템플릿을 축적할 수 있습니다.

• 더 일관된 절차: 반복 작업 전반에서 에이전트에 동일한 단계와 검토 기준을 제공합니다. 결과는 여전히 검증이 필요합니다.

• 컨텍스트 효율성: 모든 절차를 항상 불러오는 지침에 넣는 대신, 필요할 때 상세 지침을 불러옵니다.

• 도구 간 재사용: 호환되는 에이전트 간에 핵심 SKILL.md 형식을 공유할 수 있으며, 사용 전에 도구 접근 권한, 종속성, 플랫폼별 필드를 확인해야 합니다.

• 팀 유지 관리: 스킬 폴더를 버전 관리에 두면 공유 워크플로의 변경 사항을 검토할 수 있습니다.

에이전트 스킬은 Claude Code, OpenAI Codex, Cursor, GitHub Copilot, Kimi Code를 비롯해 점점 더 많은 AI 도구에서 지원됩니다. 이러한 도구는 재사용 가능한 스킬 패키지를 사용해 에이전트에 작업별 지침, 워크플로, 보조 리소스를 제공합니다.

공유되는 SKILL.md 형식 덕분에 호환되는 도구 간 스킬을 더 쉽게 재사용할 수 있지만, 설치 경로와 호출 방법은 제품마다 다릅니다. 스킬이 스크립트나 외부 도구에 의존한다면, 사용하려는 환경에서 해당 종속성을 사용할 수 있는지 확인하세요.

유용한 스킬은 반복 작업을 팀에 맞게 만드는 규칙을 담고 있습니다. 다음 예시는 패키지에 포함할 내용과 결과에서 확인할 사항을 보여 줍니다.

문서 처리와 정기적인 데이터 분석도 적합한 후보이지만, SKILL.md 외에 도구나 스크립트가 필요한 경우가 많습니다. 범위가 좁은 워크플로부터 시작해 출력을 검증하고, 작업에 필요할 때만 종속성을 추가하세요.

작업에 맞는 환경을 선택하세요. 위의 생성 방법은 자연어로 작성하는 방식과 로컬 파일 기반 워크플로를 다룹니다.

Kimi Code CLI는 프로젝트 디렉터리 .agents/skills/ 및 .kimi-code/skills/와 사용자 디렉터리 ~/.agents/skills/ 및 ~/.kimi-code/skills/에서 스킬을 찾습니다. Kimi 전용 사용자 디렉터리는 KIMI_CODE_HOME에 따라 변경할 수 있습니다. /skill:<name>으로 스킬을 호출하거나, 모델이 설명과 지원되는 트리거 필드를 바탕으로 선택하도록 할 수 있습니다. 개별 스킬의 자동 선택은 비활성화할 수 있습니다. 경로 또는 플랫폼별 필드를 구성할 때는 최신 CLI 문서를 확인하세요.

처음부터 설정할 필요는 없습니다. 데스크톱 또는 웹에서 Kimi를 열고 스킬 스토어를 둘러본 뒤, 한 번의 클릭으로 스킬을 설치해 Kimi에서 바로 사용할 수 있습니다. 리서치와 글쓰기부터 코딩, 데이터 분석까지 Kimi 스킬 스토어에서는 폭넓은 작업에 쓸 수 있는 스킬을 제공합니다. Kimi 데스크톱 또는 웹 앱에서 스토어를 둘러보고, 한 번의 클릭으로 스킬을 설치한 다음 Kimi에서 사용해 보세요.

AI 도구에 워크플로를 설명하거나 직접 SKILL.md를 작성해 스킬을 만들 수 있습니다. 회의록처럼 반복적으로 수행하며 결과를 쉽게 확인할 수 있는 작업 하나부터 시작하세요.

Kimi에서 스킬 패널을 열어 스킬을 찾거나 설치하세요. 나만의 스킬을 만들려면 절차를 업로드하거나 스킬 생성 대화에서 원하는 내용을 설명하면 됩니다. /skill-creator를 사용할 수도 있습니다. 현재 이용 가능한 진입점은 Kimi의 스킬 가이드에서 확인하세요.

1단계: Kimi의 스킬 스토어를 열고 "맞춤 설정" > "Kimi로 만들기"를 클릭합니다.

2단계: 필요한 스킬을 설명합니다.

Kimi에 작업, 예상 입력, 출력 구조, 정보가 누락되었을 때의 규칙을 알려 주세요.

예시:

결과에 규칙이 빠졌다면 Kimi에 해당 규칙을 수정해 달라고 요청하고 테스트를 반복하세요. 기존 SOP를 활용하는 경우에는 어느 부분이 지침이고 어느 부분이 배경 자료인지 지정하세요. 패키징하기 전에 관련 없거나 민감한 내용은 제거하세요. 스킬이 생성되면 바로 Kimi에서 사용할 수 있습니다.

이 예시는 텍스트 지침만 사용하며 추가 스크립트가 필요하지 않습니다. 설치와 호출 방법은 Kimi Code CLI로 설명합니다. 다른 에이전트에서는 경로와 명령어가 다를 수 있습니다.

1단계: 폴더를 만듭니다. Kimi Code CLI에서 사용자 수준 스킬을 만들려면 ~/.agents/skills/meeting-summary/를 생성하세요. 팀과 공유하는 리포지토리 수준 스킬에는 리포지토리 루트 아래의 .agents/skills/meeting-summary/를 사용하세요.

2단계: SKILL.md를 저장합니다. ~/.agents/skills/meeting-summary/SKILL.md를 만들고 다음 내용을 붙여 넣으세요. 설명에는 작업을 명시하고, 본문에는 출력과 정보 누락 시의 규칙을 정의합니다.

3단계: 새 세션을 시작하고 호출합니다. 파일을 저장한 후 새 Kimi Code CLI 세션을 시작하세요. 채팅 입력창에 다음 명령어를 입력합니다.

4단계: 결과를 확인합니다. 다음은 실제 제품 실행 기록이 아닌 예시 출력입니다. 표현은 달라질 수 있지만 섹션, 결정 사항, 담당자, 마감일은 스킬을 따라야 합니다.

5단계: 자동 선택과 적용 범위를 테스트합니다. 새 대화에서 슬래시 명령어 없이 “이 회의 메모를 회의록으로 만들어 줘”라고 요청하고 같은 메모를 제공하세요. 인터페이스에서 제공되는 경우 활동 기록을 통해 에이전트가 스킬을 불러오는지, 출력이 해당 규칙을 따르는지 확인하세요. 그런 다음 “Python에서 재귀를 설명해 줘”처럼 관련 없는 요청을 해 보세요. meeting-summary 스킬은 비활성 상태로 유지되어야 합니다. 메모 없이 스킬을 호출해 보기도 하세요. 그러면 입력을 요청해야 합니다.

스크립트, 긴 참고 자료 또는 템플릿이 필요한 경우 scripts/, references/, assets/를 추가하고 SKILL.md에서 연결하세요. 최신 경로와 호출 옵션은 Kimi Code CLI 스킬 문서에서 확인하세요.

• 명확한 트리거를 정의하세요: 작업 내용과 스킬을 사용할 시점을 모두 설명하세요. 사용자가 자연스럽게 쓰는 용어를 포함하고, 관련 있는 요청과 관련 없는 요청을 모두 테스트하세요.

• 지침을 집중적으로 유지하세요: 사양에서는 기본 파일을 500줄 미만, 5,000 token 미만으로 권장합니다. 이는 줄 수를 token 수로 변환하라는 뜻이 아니라 별개의 지침입니다. 자세한 참고 자료는 보조 파일로 옮기세요.

• 관찰 가능한 결과물 명시: 필수 섹션, 입력 및 출력 예시, 정보가 누락된 경우의 규칙을 포함합니다.

• 종속성 문서화: 필요한 도구와 패키지를 파악하고, 적절한 경우 호환성 메타데이터를 사용합니다. 플랫폼별 확장 기능은 이식 가능한 핵심 기능과 분리해 둡니다.

• 영향이 큰 작업 통제: 메시지를 보내거나 변경 사항을 배포하는 워크플로에는 명시적 호출 방식과 적절한 승인 규칙을 적용합니다. 수동 호출만으로는 권한 확인을 대체할 수 없습니다.

• 타사 패키지 검토: 설치 전에 지침과 포함된 스크립트를 살펴보고, 어떤 데이터와 권한을 사용하는지 확인합니다.

에이전트 스킬은 반복 작업을 호환되는 AI 에이전트가 필요할 때 불러올 수 있는 재사용 가능한 워크플로로 바꿉니다. 스킬을 언제 사용하고 어떤 결과를 만들어야 하는지 정의한 간결한 SKILL.md부터 시작하세요. 작업에 필요한 경우에만 스크립트나 참조 자료를 추가한 뒤, 스킬이 활성화되는 시점과 출력 품질을 테스트하세요.