Agent/docs/ref/skills.md

Skill structure Every Skill requires a SKILL.md file with YAML frontmatter:

---

name: your-skill-name

description: Brief description of what this Skill does and when to use it

Your Skill Name

Instructions

[Clear, step-by-step guidance for Claude to follow]

Examples

[Concrete examples of using this Skill] Required fields: name and description

Field requirements:

name:

Maximum 64 characters Must contain only lowercase letters, numbers, and hyphens Cannot contain XML tags Cannot contain reserved words: "anthropic", "claude" description:

Must be non-empty Maximum 1024 characters Cannot contain XML tags The description should include both what the Skill does and when Claude should use it. For complete authoring guidance, see the best practices guide.