skill-writer

A valid SKILL.md file for Claude Code requires structured frontmatter with mandatory name and description fields, alongside optional references, examples, scripts, and assets sections. Proper validation ensures the directory structure enforces constraints on naming and content quality for reliable skill discovery.

The required frontmatter fields for Claude Skill validation are name and description. Optional sections including references, examples, scripts, and assets must only be populated when relevant, ensuring the SKILL.md structure passes official validation rules for discoverability.

Your Claude Code Skill may not be discovered due to invalid SKILL.md frontmatter, incorrect directory structure, or failing content quality constraints. Troubleshooting skill discovery involves validating required fields like name and description, and ensuring optional components are correctly populated.

To structure a multi-file Claude Code Skill, use progressive disclosure patterns within your SKILL.md by separating optional assets, scripts, and references into distinct files. Validation rules require including optional sections only when populated, ensuring the directory structure remains clean.

Yes, you can use templates to generate Claude Code Skills. Templates provide ready-to-use SKILL.md structures for both single-file and multi-file Skills, guiding the writing of required frontmatter and progressive disclosure patterns while enforcing official validation constraints.