skill-creator-frontmatter

name	skill-creator-frontmatter
description	Complete reference for Claude Code skill YAML frontmatter fields, their values, and best practices. Use when writing frontmatter for SKILL.md, configuring skill invocation, setting allowed-tools, or deciding on skill metadata fields.

SKILL.md Frontmatter Reference

The YAML frontmatter between --- markers at the top of SKILL.md controls how Claude discovers and runs your skill. The frontmatter is loaded into Claude's system prompt (Level 1 of progressive disclosure), so keep it concise.

Required Format

---
name: your-skill-name
description: What it does. Use when user asks to [specific phrases].
---

Both --- delimiters must appear on their own lines. Everything between them is parsed as YAML.

Field Reference

name

Display name and slash-command identifier.

• Type: string
• Required: No (defaults to folder name)
• Constraints: kebab-case only, max 64 characters, lowercase letters/numbers/hyphens
• Must match the skill's folder name
• Reserved prefixes: "claude", "anthropic" (will be rejected)