Agent Skills 완벽 가이드: AI에게 '손과 발'을 달아주는 법

🧠 AI에게 '뇌'는 있지만 '손'이 없다면?

우리가 사용하는 ChatGPT나 Claude는 엄청난 지능(Brain)을 가지고 있습니다. 하지만 그들은 '채팅창'이라는 감옥에 갇혀 있죠.

• "파일을 저장해줘" → "저는 텍스트 모델이라 파일을 만들 수 없습니다."
• "내 컴퓨터 IP 알려줘" → "저는 인터넷에 연결된 서버라 당신의 로컬 정보를 모릅니다."

이때 필요한 것이 바로 **Skill(스킬)**입니다. Skill은 AI에게 터미널 실행 권한, 파일 시스템 접근 권한, API 호출 능력을 부여합니다. 즉, AI에게 '손과 발'을 달아주는 것입니다.

---

🌍 ClawHub 추천 스킬 TOP 10 (안전 & 필수)

오픈소스 진영에서는 이미 수많은 스킬들이 공유되고 있습니다. 그중에서도 보안이 검증되고, 실용성이 뛰어난 필수 스킬들을 분야별로 소개합니다.

터미널에서 clawhub install <스킬명> 한 줄이면 바로 내 에이전트가 똑똑해집니다!

🔍 정보 수집 (Research)

1. web-search (필수)
   • 기능: 구글이나 Brave 검색 엔진을 통해 실시간 최신 정보를 찾아옵니다.
   • 사용법: "최신 아이폰 가격 검색해줘"
2. pdf-reader
   • 기능: 긴 PDF 논문이나 보고서를 읽고 내용을 요약하거나 특정 정보를 찾습니다.
   • 사용법: "이 논문 파일 읽고 핵심 내용 3줄 요약해줘"
3. youtube-summary
   • 기능: 유튜브 영상 자막을 가져와 내용을 분석합니다. (영상 볼 시간 없을 때 최고!)
   • 사용법: "이 영상 링크 내용 요약해줘"

🛠️ 개발 & 데이터 (Dev & Data)

4. code-interpreter (강력 추천)
   • 기능: 파이썬 코드를 즉석에서 실행하여 복잡한 수학 계산, 데이터 분석, 그래프 그리기를 수행합니다.
   • 사용법: "이 엑셀 파일 데이터로 매출 추이 그래프 그려줘"
5. git-helper
   • 기능: Git 상태 확인, 커밋 메시지 작성, 로그 분석 등을 도와줍니다.
   • 사용법: "지금 변경 사항으로 커밋 메시지 작성해줘"
6. json-formatter
   • 기능: 복잡한 JSON 데이터를 보기 좋게 정렬하거나 검증합니다.

📅 생산성 (Productivity)

7. google-calendar
   • 기능: 내 구글 캘린더 일정을 확인하고, 새로운 일정을 추가합니다.
   • 사용법: "내일 오후 2시에 미팅 잡아줘"
8. notion-connector
   • 기능: 대화 내용을 노션 페이지로 저장하거나, 노션에 있는 문서를 읽어옵니다.
   • 사용법: "방금 정리한 회의록 노션에 저장해줘"
9. slack-notify
   • 기능: 중요한 알림을 슬랙 채널로 보냅니다. (서버 모니터링용으로 딱!)
   • 사용법: "서버 다운되면 슬랙으로 알림 보내"
10. gmail-summary
    • 기능: 읽지 않은 중요한 이메일만 골라서 아침 브리핑을 해줍니다.

---

🛠️ 실전: 나만의 스킬 만들기 (Deep Dive)

남이 만든 것만 쓸 수는 없죠. 내 업무에 딱 맞는 스킬을 직접 만들어봅시다. 가장 기본적인 **"환율 계산기"**를 예로 들어보겠습니다.

1. 구조 잡기

스킬은 보통 두 개의 파일로 구성됩니다.

• SKILL.md: AI를 위한 설명서 (사용법, 예시)
• script.py (또는 .js, .sh): 실제 기능을 수행하는 코드

2. 코드 작성 (exchange.py)

import requests
import sys

def get_rate(currency):
    url = f"https://api.exchangerate-api.com/v4/latest/USD"
    response = requests.get(url).json()
    rate = response['rates'].get(currency.upper())
    
    if rate:
        print(f"1 USD = {rate} {currency.upper()}")
    else:
        print("Error: Currency not found.")

if __name__ == "__main__":
    # AI가 "KRW" 같은 인자를 넘겨줍니다.
    target_currency = sys.argv[1] if len(sys.argv) > 1 else "KRW"
    get_rate(target_currency)

3. 설명서 작성 (SKILL.md)

이 부분이 가장 중요합니다. AI는 이 파일을 읽고 "아, 이 도구는 이렇게 쓰는 거구나"라고 학습합니다.

---
name: exchange-rate
description: Check real-time exchange rates based on USD.
---

# Exchange Rate Skill

## Usage
Use this skill when the user asks for exchange rates.

```bash
python3 exchange.py [CURRENCY_CODE]

Examples

• User: "How much is Won against Dollar?" -> Command: python3 exchange.py KRW
• User: "Euro rate?" -> Command: python3 exchange.py EUR

### 4. OpenClaw에 등록

스킬 폴더(`~/.openclaw/workspace/skills/exchange-rate`)에 위 파일들을 넣고 OpenClaw를 재시작하면 끝!
이제 AI에게 **"지금 원달러 환율 얼마야?"**라고 물어보면, AI가 `exchange.py`를 실행해서 답을 줍니다.

---

## 🚀 배포하기 (ClawHub Publish)

내가 만든 스킬이 유용하다면, 전 세계 사람들과 공유하세요.

```bash
# 로그인
clawhub login

# 배포
clawhub publish skills/exchange-rate

당신의 코드가 누군가의 AI 비서를 더 똑똑하게 만들 수 있습니다.

---

🔗 마치며: 연결의 힘

Skill의 진정한 가치는 **연결(Chaining)**에 있습니다.

• web-search 스킬로 최신 AI 뉴스를 찾고,
• summarizer 스킬로 내용을 요약하고,
• slack-notify 스킬로 팀 채널에 공유합니다.

이 모든 것을 오케스트레이션하는 것이 바로 AI 에이전트의 역할입니다. 지금 바로 당신만의 스킬을 만들어보세요. 상상하는 모든 것이 가능해집니다.