skill-writer

To create a well-structured Claude Skill, generate a SKILL.md file with validated frontmatter fields like name and description, then add supporting files such as references and scripts to ensure reliable discovery and consistent behavior.

The correct folder structure for a multi-file Claude Skill centers on a SKILL.md file, optionally accompanied by references, examples, scripts, and assets directories to maintain progressive disclosure and documentation quality.

Validate SKILL.md frontmatter by checking field correctness for required metadata like name and description, ensuring documentation quality, and verifying safe metadata inclusion for dependencies and components to pass toxicity checks.

Best practices for writing SKILL.md documentation involve structuring content for progressive disclosure, validating required frontmatter fields, and providing supportive files like templates and examples to guide users and maintain reliability.

Yes, you can include scripts and templates inside a Claude Skill folder as supportive files. These accompanying assets help guide SKILL.md generation, provide examples, and ensure the skill's maintainability and reliable behavior.