# Claude Skills - SKILL.md Format Requirements

## 📝 Claude Skills SKILL.md Format

Every Claude Skill's SKILL.md file MUST start with YAML frontmatter between triple dashes:

```yaml
---
name: skill-name-here
version: 1.0.0
description: Brief description of what the skill does
author: Your Name/Team
tags:
  - tag1
  - tag2
  - tag3
---

# Skill Name

Rest of your skill content goes here...
```

### ✅ Example:
```yaml
---
name: seo-gateway-strategist
version: 1.0.0
description: Creates comprehensive SEO-focused gateway page strategies for Korean medical/service websites
author: OurDigital Dr.D
tags:
  - seo
  - strategy
  - korean-marketing
  - gateway-pages
  - content-planning
---

# SEO Gateway Page Strategist

This skill helps you create...
```

## 🔑 Key Requirements for Claude Skills

1. **YAML Frontmatter is MANDATORY**
   - Must be at the very beginning of SKILL.md
   - Must be wrapped in triple dashes (---)
   - Must include at minimum: name, version, description

2. **File Structure**
   - All files must be inside the top-level folder
   - SKILL.md must be in the root of the skill folder
   - Subfolders (templates/, scripts/, examples/) are allowed

3. **Naming Conventions**
   - Use lowercase with hyphens for skill name
   - No spaces or special characters in folder/file names
   - Version should follow semantic versioning (x.y.z)

## 📂 Correct Folder Structure

```
skills-name/              # Top-level folder
├── SKILL.md                         # Must have YAML frontmatter
├── README.md                        # Documentation
├── scripts/                         # Optional subfolder
│   └── keyword_analyzer.py
├── templates/                       # Optional subfolder
│   └── *.md
└── examples/                        # Optional subfolder
    └── *.md
```
