Skills는 에이전트가 도구를 사용하는 방법과 시점을 알려줍니다. 각 스킬은 YAML 프런트매터와 markdown 지침이 포함된Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
SKILL.md 파일을 담은 디렉터리입니다.
스킬이 로드되고 우선순위가 지정되는 방식은 Skills를 참조하세요.
첫 번째 스킬 만들기
SKILL.md 작성
해당 디렉터리 안에 스킬
SKILL.md를 만드세요. 프런트매터는 메타데이터를 정의하고,
markdown 본문은 에이전트를 위한 지침을 포함합니다.name에는 소문자, 숫자, 하이픈으로 된 하이픈 표기법을 사용하세요.
폴더 이름과 프런트매터 name을 일치시키세요.도구 추가(선택 사항)
프런트매터에서 사용자 지정 도구 스키마를 정의하거나 에이전트가 기존 시스템 도구
(
exec 또는 browser 등)를 사용하도록 지시할 수 있습니다. Skills는 문서화하는 도구와 함께
Plugin 안에 포함되어 배포될 수도 있습니다.스킬 메타데이터 참조
YAML 프런트매터는 다음 필드를 지원합니다.| 필드 | 필수 여부 | 설명 |
|---|---|---|
name | 예 | 소문자, 숫자, 하이픈을 사용하는 고유 식별자 |
description | 예 | 에이전트에 표시되는 한 줄 설명 |
metadata.openclaw.os | 아니요 | OS 필터(["darwin"], ["linux"] 등) |
metadata.openclaw.requires.bins | 아니요 | PATH에 필요한 바이너리 |
metadata.openclaw.requires.config | 아니요 | 필요한 config 키 |
모범 사례
- 간결하게 작성 — AI가 되는 방법이 아니라 모델이 무엇을 해야 하는지 지시하세요
- 안전을 최우선으로 — 스킬이
exec를 사용하는 경우 프롬프트가 신뢰할 수 없는 입력에서 임의 명령 삽입을 허용하지 않도록 하세요 - 로컬에서 테스트 — 공유하기 전에
openclaw agent --message "..."를 사용해 테스트하세요 - ClawHub 사용 — ClawHub에서 스킬을 둘러보고 기여하세요
스킬 위치
| 위치 | 우선순위 | 범위 |
|---|---|---|
\<workspace\>/skills/ | 가장 높음 | 에이전트별 |
\<workspace\>/.agents/skills/ | 높음 | 워크스페이스 에이전트별 |
~/.agents/skills/ | 중간 | 공유 에이전트 프로필 |
~/.openclaw/skills/ | 중간 | 공유(모든 에이전트) |
| 번들(OpenClaw와 함께 제공) | 낮음 | 전역 |
skills.load.extraDirs | 가장 낮음 | 사용자 지정 공유 폴더 |
관련 항목
- Skills 참조 — 로드, 우선순위, 게이팅 규칙
- Skills config —
skills.*config 스키마 - ClawHub — 공개 스킬 레지스트리
- Plugin 빌드 — Plugin은 Skills를 포함해 배포할 수 있음