스킬 생성 및 게시
자신만의 스킬을 만들어 스킬 마켓플레이스에 공유하세요
Claw Buff 계정이 있는 누구나 스킬 마켓플레이스에서 스킬을 만들고 게시할 수 있습니다.
스킬 만들기
스킬 마켓플레이스로 이동하여 스킬 게시를 클릭하거나, 스킬 편집기로 직접 이동하세요.
편집기
스킬 편집기는 두 개의 패널로 구성됩니다:
왼쪽 패널 — SKILL.md 내용:
Markdown으로 스킬 지침을 작성하세요. 이것이 스킬의 핵심입니다 — 에이전트에게 작업 수행 방법을 가르치는 프롬프트 문서입니다. 고급 동작을 위한 선택적 스크립트 파일(JS/TS)도 업로드할 수 있습니다.
오른쪽 패널 — 메타데이터:
| 필드 | 필수 | 설명 |
|---|---|---|
| 이름 | 예 | 표시 이름 (최소 2자) |
| 설명 | 예 | 카드에 표시되는 짧은 요약 |
| 카테고리 | 예 | 개발, 생산성, 커뮤니케이션 등 중 하나 |
| 태그 | 아니오 | 쉼표로 구분된 검색용 라벨 |
| 버전 | 예 | 시맨틱 버전 (예: 1.0.0) |
좋은 SKILL.md 작성하기
스킬의 품질은 전적으로 지침의 명확성에 달려 있습니다. 다음 구조를 따르세요:
---
name: my-skill
description: 이 스킬이 하는 일을 한 문장으로
version: 1.0.0
---
# My Skill
## 개요
에이전트가 이 스킬로 할 수 있는 일에 대한 간략한 설명.
## 명령 / 워크플로
에이전트가 따라야 할 단계별 지침.
어떤 도구를 어떤 순서로 사용할지 구체적으로 지정.
## 예시
에이전트가 예상 동작을 이해할 수 있도록
구체적인 입력/출력 예시를 보여줌.
## 제한 사항
이 스킬이 할 수 없거나 시도하면 안 되는 것.최고의 스킬은 집중적이고 구체적입니다. 한 가지를 잘 하는 스킬이 모든 것을 다루려는 스킬보다 유용합니다. "일반 코딩 도우미"가 아닌 "GitHub PR 리뷰어"를 생각하세요.
저장 및 게시
두 가지 옵션이 있습니다:
- 임시 저장 — 게시하지 않고 저장합니다. 임시 저장은 본인만 볼 수 있습니다. 작업 중인 스킬에 유용합니다.
- 게시 — 검토를 위해 스킬을 제출하고, 승인 후 마켓플레이스에 공개합니다.
검토 프로세스
스킬을 게시하면 다음이 발생합니다:
- 자동 보안 스캔 — 스크립트 파일(있는 경우)에서 알려진 악성 패턴(리버스 셸, 데이터 유출, 자격 증명 탈취)을 검사합니다.
- 검토 상태 — 스캔을 통과한 스크립트 포함 스킬은 "검토 대기" 상태가 됩니다. 스크립트가 없는 스킬(SKILL.md만)은 자동 승인됩니다.
- 알림 — 스킬이 승인 또는 거부되면 알림을 받습니다. 거부된 스킬에는 이유를 설명하는 검토 메모가 포함됩니다.
SKILL.md만 포함된 스킬(스크립트 파일 없음)은 실행 코드가 없는 순수 프롬프트 문서이므로 자동 승인됩니다. 스크립트를 추가하면 보안 검토 파이프라인이 시작됩니다.
스킬 관리
내 스킬
마켓플레이스 페이지에서 내 스킬 탭을 클릭하여 모든 스킬과 상태를 확인하세요:
| 상태 | 의미 |
|---|---|
| 게시됨 (녹색) | 마켓플레이스에 공개, 모두에게 표시 |
| 검토 대기 (황색) | 제출됨, 승인 대기 중 |
| 거부됨 (적색) | 검토 메모와 함께 거부 — 수정 후 재제출 |
| 미게시 (회색) | 임시 저장 또는 수동으로 게시 취소 |
편집
스킬을 클릭하여 편집기에서 열 수 있습니다. 다음을 업데이트할 수 있습니다:
- SKILL.md 내용
- 메타데이터 (이름, 설명, 카테고리, 태그)
- 버전 번호
- 스크립트 파일
게시된 스킬의 변경 사항은 저장 후 즉시 반영됩니다.
게시 취소
마켓플레이스에서 스킬을 삭제하지 않고 일시적으로 제거하려면:
- 편집기에서 스킬 열기
- 위험 영역에서 게시 취소 클릭
스킬이 임시 저장 상태가 됩니다. 언제든지 다시 게시할 수 있습니다.
삭제
스킬을 영구 삭제하려면:
- 편집기에서 스킬 열기
- 위험 영역에서 삭제 클릭
- 삭제 확인
삭제는 영구적이며 되돌릴 수 없습니다. 사용자가 이미 스킬을 설치한 경우, 설치된 사본은 에이전트에 남아 있지만 향후 업데이트는 제공되지 않습니다.
모범 사례
- 지침을 구체적으로 작성하세요. "GitHub 사용을 도와줘"는 모호합니다. "
gh pr create를 사용하여 스테이징된 변경 사항으로 Pull Request를 생성해"가 실행 가능합니다. - 예시를 포함하세요. 좋은 입력과 출력이 어떤 것인지 보여주세요. 이는 스킬의 신뢰성을 크게 향상시킵니다.
- 종속성을 선언하세요. 스킬에 API 키나 바이너리가 필요하면 SKILL.md frontmatter와 설명에 명확히 언급하세요.
- 의미 있게 버전을 관리하세요. 변경할 때 버전을 올리세요. 사용자와 플랫폼이 버전 기록을 추적합니다.
- 게시 전에 테스트하세요. 자신의 에이전트에 스킬을 설치하고 예상대로 작동하는지 확인한 후 공개하세요.
- 명확한 설명을 작성하세요. 이것이 사용자가 가장 먼저 보는 것입니다. 구체적으로 — 이 스킬이 에이전트를 위해 실제로 무엇을 할 수 있는지 알려주세요.