스킬 만들기 - OpenClaw 실전 가이드 beta

자신만의 스킬을 만들어 AI의 능력을 확장하세요.

최소 구조

mkdir -p skills/my-skill
cd skills/my-skill

my-skill/
├── SKILL.md       # 필수: AI가 읽는 지시서
└── package.json   # 선택: 메타데이터

SKILL.md 작성

# My Custom Skill

## 목적
이 스킬은 [기능 설명]을 합니다.

## 사용법
- `[트리거 문구]` → [동작 설명]

## 규칙
- [AI가 따라야 할 규칙]
- [예외 상황 처리]

## 도구
이 스킬은 다음 CLI 도구를 사용합니다:
- `my-tool --action check`: 상태 확인
- `my-tool --action run`: 실행

## 예시
사용자: "X 해줘"
AI: [예상 동작 설명]

SKILL.md가 곧 스킬입니다. 별도의 코드 없이도, 잘 작성된 SKILL.md만으로 AI의 행동을 바꿀 수 있습니다.

실전 예시: 독서 기록 스킬

# 독서 기록 스킬

## 목적
읽은 책을 기록하고 관리합니다.

## 데이터 위치
`memory/books.json`

## 사용법
- "이 책 읽었어: [제목] by [저자]" → 목록에 추가
- "올해 읽은 책 목록" → 목록 출력
- "책 추천해줘" → 읽은 책 기반 추천

## 데이터 형식
```json
[
  {
    "title": "책 제목",
    "author": "저자",
    "date": "2026-02-11",
    "rating": 4,
    "notes": "한줄평"
  }
]

규칙

같은 책 중복 등록 방지
rating은 1-5 스케일
추천 시 읽은 책의 장르와 rating 참고

## 스크립트 포함 스킬

복잡한 로직이 필요하면 스크립트를 추가합니다:

my-skill/ ├── SKILL.md ├── scripts/ │ ├── check.sh │ └── run.py └── package.json

<Tip>
처음에는 SKILL.md만으로 시작하세요.
AI가 기존 도구(exec, web_search 등)를 조합해서 대부분의 작업을 처리할 수 있습니다.
복잡해지면 그때 스크립트를 추가하면 됩니다.
</Tip>

## ClawHub에 공유

```bash
# 스킬 패키징
openclaw skills pack my-skill

# ClawHub에 발행
openclaw skills publish my-skill