스킬을 사용하면 전문 지식과 맞춤 워크플로를 통해 에이전트 모드의 기능을 향상할 수 있습니다. Agent Skills 개방형 표준을 기반으로 합니다.
AGENTS.md 파일과 달리 스킬은 주문형 전문성을 나타냅니다. 이 구조를 통해 에이전트 모드는 모델의 즉각적인 컨텍스트 창을 어수선하게 만들지 않고도 특정 라이브러리 버전 간에 이전하거나 컴포저블을 다양한 화면 크기에 맞게 조정하는 등 다양한 전문 기능을 유지할 수 있습니다.
모델은 요청과 스킬의 설명을 기반으로 스킬을 사용할 시기를 자율적으로 결정합니다. 관련 기술이 식별되면 모델은 작업을 완료하는 데 필요한 전체 안내와 리소스를 동적으로 가져옵니다.
주문형으로 스킬을 활성화하려면 에이전트에게 스킬과 관련된 작업을 실행해 달라고 요청하세요. 입력 상자에 @를 입력하여 특정 스킬을 트리거할 수도 있습니다.
주요 장점
- 전문 지식 공유: 특정 팀의 풀 요청 검토 프로세스와 같은 복잡한 워크플로를 누구나 사용할 수 있는 전용 폴더에 패키징합니다.
- 반복 가능한 워크플로: 표준 안내를 제공하여 복잡한 다단계 작업을 일관되게 실행할 수 있습니다.
- 리소스 번들링: 에이전트가 한곳에서 필요한 모든 것을 갖출 수 있도록 스크립트, 템플릿 또는 예시 데이터를 안내와 함께 포함합니다.
- 컨텍스트 윈도우 효율적 사용: 컨텍스트 토큰을 절약하기 위해 스킬의 메타데이터 (이름 및 설명)만 처음 로드됩니다. 전체
SKILL.md파일은 활성화 시에만 로드됩니다.references/,scripts/또는assets/디렉터리 내의 지원 파일은 에이전트가 특별히 필요할 때만 컨텍스트에 로드됩니다.
나만의 스킬 만들기
에이전트는 프로젝트 루트에 있는 .skills/ 또는 .agent/skills/ 디렉터리에서 시작하여 스킬을 찾습니다. 맞춤 스킬을 빌드하려면 다음 단계를 따르세요.
- 스킬의 디렉터리를 만듭니다 (예:
my-new-skill/). - 새 디렉터리 내에
SKILL.md파일 (대소문자 구분)을 만듭니다.
스킬은 다음 규칙을 따라야 합니다.
- 스킬별 디렉터리 하나: 각 스킬에는
SKILL.md파일과 추가 리소스가 포함된 고유한 디렉터리가 있어야 합니다. - 중첩: 모든 스킬은 프로젝트 루트의
.skills/또는.agent/skills/디렉터리에 있어야 합니다. 하지만 더 나은 구성을 위해 하위 디렉터리를 사용할 수 있습니다 (예:skills/ui-flows/<skill name>/SKILL.md또는skills/testing/<skill name>/SKILL.md). - 범위: 현재는 프로젝트의 코드베이스 내에 있는 스킬만 지원됩니다.
SKILL.md 파일은 메타데이터에 YAML 블록을 사용하고 안내에는 표준 Markdown을 사용합니다.
name: 스킬의 고유 식별자입니다. 디렉터리 이름과 일치해야 합니다.description: 스킬의 기능과 에이전트가 스킬을 사용해야 하는 시점에 대한 명확한 설명입니다.- 본문: YAML 블록 아래의 마크다운 본문에는 스킬이 활성 상태일 때 에이전트의 동작을 안내하는 명령어가 포함되어 있습니다.
---
name: skill-name
description: A description of what this skill does and when to use it.
metadata:
author: example-org
version: "1.0"
---
Skill content
형식 가이드라인
- 이름: 최대 64자 (소문자, 숫자, 하이픈만 사용 가능)
- 설명: 최대 1,024자(영문 기준)
- 본문 콘텐츠: 10,000~20,000자 (토큰 2,500~5,000개)를 목표로 합니다. 안내가 이 한도를 초과하는 경우 선택적 스킬 디렉터리에 설명된 대로 자세한 문서를 리소스 파일로 이동하는 것이 좋습니다.
선택적 스킬 디렉터리
SKILL.md 파일을 간결하고 모듈화된 상태로 유지하려면 스킬 폴더 내의 다음 선택적 디렉터리에 추가 리소스를 포함하면 됩니다.
scripts/: 에이전트가 실행할 수 있는 실행 코드 (예: Python 또는 Bash)를 포함합니다.references/: 자세한 기술 문서, API 참조 또는 도메인별 가이드가 포함되어 있습니다.assets/: 문서 템플릿, UI 다이어그램, JSON 스키마와 같은 정적 리소스가 포함됩니다.
SKILL.md 명령어 내에서 이러한 파일을 참조할 때는 스킬 루트의 상대 경로를 사용합니다. 예: Run the script at scripts/cleanup.py