Files
our-claude-skills/reference/SKILL-FORMAT-REQUIREMENTS.md
Andrew Yim 341d5f5a5b Initial commit: Claude Skills Factory with 8 refined custom skills
Custom Skills (ourdigital-custom-skills/):
- 00-ourdigital-visual-storytelling: Blog featured image prompt generator
- 01-ourdigital-research-publisher: Research-to-publication workflow
- 02-notion-organizer: Notion workspace management
- 03-research-to-presentation: Notion research to PPT/Figma
- 04-seo-gateway-strategist: SEO gateway page strategy planning
- 05-gateway-page-content-builder: Gateway page content generation
- 20-jamie-brand-editor: Jamie Clinic branded content GENERATION
- 21-jamie-brand-guardian: Jamie Clinic content REVIEW & evaluation

Refinements applied:
- All skills converted to SKILL.md format with YAML frontmatter
- Added version fields to all skills
- Flattened nested folder structures
- Removed packaging artifacts (.zip, .skill files)
- Reorganized file structures (scripts/, references/, etc.)
- Differentiated Jamie skills with clear roles

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-10 17:56:04 +09:00

1.8 KiB

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:

---
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:

---
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