skill-writer

Create a SKILL.md file with frontmatter metadata (name, description) enclosed in triple dashes, followed by your Skill content. Frontmatter validation ensures consistent structure and discoverability across all your Skills.

Use a Skill directory containing SKILL.md as the core file, plus optional references.md, examples.md, and scripts/ or assets/ folders. This progressive disclosure structure maximizes usability and keeps related files organized.

Validate your SKILL.md frontmatter with required fields (name, description), organize files consistently, and check that your Skill placement matches your scope (personal or project-level). Validation checks catch discovery and activation issues early.

Yes. The Skill Writer provides step-by-step templates and best-practice guidelines for SKILL.md structure, content organization, and optional components. Templates reduce manual errors and accelerate consistent Skill development.

References.md documents external sources or related concepts; examples.md provides concrete use cases; scripts/ and assets/ folders hold automation or resource files. Include only components your Skill actually needs.

Check frontmatter syntax, verify file placement (personal vs. project scope), ensure SKILL.md exists at the root, and validate consistency across all Skill files. The Skill Writer guides diagnostic steps for common activation and discovery failures.