문서

Skill 만들기

Skill은 YAML 프론트매터가 있는 Markdown 파일입니다. 공유할 가치 있는 도메인 전문 지식이 있다면 SKILL.md에 작성하세요.

파일 구조

SKILL.md
---
name: my-skill
description: One sentence shown in lazy-load preview.
version: 1.0.0
author: your-github-username
tags:
  - laravel
  - php
  - testing
---

# My Skill

## Overview

What this skill teaches Claude and when to apply it.

## Conventions

- Always use X instead of Y
- Prefer Z pattern for ABC scenarios

## Examples

```php
// Your code examples here
```

프론트매터 필드

필드 필수 설명
name 필수 URL 친화적인 식별자.
description 필수 한 문장 — 지연 로딩 미리보기와 카탈로그 목록에 표시됩니다.
version 선택 시맨틱 버전 (예: 1.0.0).
author 선택 GitHub 사용자 이름.
tags 선택 검색 및 필터링을 위한 태그 배열.

콘텐츠 가이드라인

  • 구체적으로 작성하세요. "$query->whereNull('deleted_at')을 항상 사용"이 "소프트 삭제 사용"보다 유용합니다.
  • 예시를 포함하세요. 코드 블록은 지시를 명확하게 만듭니다.
  • 컨텍스트를 명시하세요. 이 Skill은 어떤 프로젝트 유형, 프레임워크, 상황에 적용되나요?
  • 집중력을 유지하세요. 하나의 Skill = 하나의 도메인. Laravel + 보안 + 테스트를 하나의 파일에 묶지 마세요.

카탈로그에 제출

  1. 1 Skill을 공개 GitHub 저장소에 푸시합니다.
  2. 2 제출 페이지로 이동하여 저장소 URL을 입력합니다.
  3. 3 Claude API가 Skill의 안전성과 품질을 분석합니다.
  4. 4 승인되면 몇 분 안에 카탈로그에 표시됩니다.

안전 분석

제출된 모든 Skill은 Claude가 프롬프트 인젝션, 무단 파일 접근, 데이터 유출 패턴을 분석합니다. 위험으로 표시된 Skill은 관리자가 검토합니다. Skill을 지식에만 집중시키고 코드 실행이나 외부 요청을 피하면 원활한 승인이 보장됩니다.