skill-writer

To write SKILL.md frontmatter, ensure the skill name matches the directory and the description includes specific what-and-when triggers. Correct frontmatter also requires naming rules and optional tool restrictions for Claude Code skill authoring.

Skill discovery fails when the SKILL.md frontmatter lacks a clear what+when description or the skill name does not match the directory. Troubleshooting validation failures requires checking these structural rules across personal and project skill locations.

The best way to structure operational instructions is using clear, structured sections for step-by-step guidance and example usage. Production-ready skills follow best-practice validation rules and include optional supporting files like reference materials.

Defining a skill scope requires choosing a single capability so the skill triggers on the right requests. Proper skill design prevents discovery failures by ensuring the SKILL.md description matches the intended operational instructions.

You can update an existing skill structure while maintaining validation by ensuring the SKILL.md frontmatter follows naming rules and the description retains specific what-and-when triggers. Correctly structured content passes validation checks across personal and project skill locations.

Tool restrictions in SKILL.md frontmatter are optional during skill authoring. You need to enforce them only when the skill's operational instructions require limiting the Claude Code agent's available toolset for safety or scope control.