SKILL.md 형식

SKILL.md 파일 형식의 전체 명세입니다.

개요

SKILL.md 파일은 YAML 프론트매터가 포함된 마크다운을 사용하여 Agent Skill을 정의합니다.

파일 구조

markdown

---
# YAML Frontmatter (metadata)
name: Skill Name
description: Brief description
---

# Main Content
Your skill instructions in Markdown format.

프론트매터 필드

필수 필드

| 필드 | 타입 | 설명 | |-------|------|-------------| | name | string | 스킬 이름 (최대 50자) | | description | string | 간단한 설명 (최대 200자) |

선택 필드

| 필드 | 타입 | 설명 | |-------|------|-------------| | version | string | 시맨틱 버전 (예: "1.0.0") | | author | string | 작성자 이름 또는 조직 | | license | string | 라이선스 유형 (예: "MIT") | | platforms | array | 지원되는 플랫폼 | | categories | array | 스킬 카테고리 | | tags | array | 검색 키워드 | | repository | string | 소스 저장소 URL | | website | string | 문서 웹사이트 |

프론트매터 예시

yaml

---
name: React Best Practices
description: Guidelines for writing clean React components
version: 2.1.0
author: React Community
license: MIT
platforms:
  - claude-code
  - codex
  - chatgpt
categories:
  - development
  - frontend
tags:
  - react
  - javascript
  - components
---

콘텐츠 구조

권장 섹션

markdown

# Skill Name

## Context
Background information and domain knowledge.

## Guidelines
Specific rules and best practices.

## Do's and Don'ts
Clear behavioral guidance.

## Examples
Sample interactions or code snippets.

## References
Links to additional resources.

서식 팁

콘텐츠 구성에 제목(#, ##, ###) 사용
가이드라인에 글머리 기호 목록 사용
예시에 코드 블록 사용
핵심 포인트 강조에 굵은 글씨 사용
단락을 간결하게 유지

플랫폼 필드

스킬이 지원하는 플랫폼 지정:

yaml

platforms:
  - claude-code    # Claude Code CLI
  - codex          # Codex CLI
  - chatgpt        # ChatGPT Custom Instructions

검증

SKILL.md는 다음이 검증됩니다:

유효한 YAML 프론트매터 문법
필수 필드 존재
필드 길이 제한
유효한 카테고리/플랫폼 값
마크다운 서식

전체 예시

markdown

---
name: TypeScript Best Practices
description: Guidelines for writing type-safe, maintainable TypeScript code
version: 1.0.0
author: TypeScript Community
license: MIT
platforms:
  - claude-code
  - codex
categories:
  - development
  - frontend
  - backend
tags:
  - typescript
  - javascript
  - types
---

# TypeScript Best Practices

## Context
This skill provides guidelines for writing high-quality TypeScript code.

## Guidelines

### Type Safety
- Always define explicit types for function parameters
- Avoid using `any` type
- Use type guards for runtime checks

### Code Organization
- One export per file for main modules
- Group related types in a `types.ts` file
- Use barrel exports for public APIs

## Do's and Don'ts

### Do
- Use strict mode
- Define interfaces for object shapes
- Use generics for reusable code

### Don't
- Suppress TypeScript errors with `@ts-ignore`
- Use `any` as a quick fix
- Mix JavaScript and TypeScript in the same project

## Examples

### Good: Explicit Types
\`\`\`typescript
function greet(name: string): string {
  return \`Hello, \${name}!\`;
}
\`\`\`

### Bad: Implicit Any
\`\`\`typescript
// Avoid this
function greet(name) {
  return \`Hello, \${name}!\`;
}
\`\`\`