skill-writer

To create a Claude Skill, document its scope, structure, and validation steps, then save the file as SKILL.md in your project repository. Enforce YAML frontmatter requirements by including required name and description fields for proper Skill discovery.

The required frontmatter fields for a SKILL.md file are name and description. Validating these YAML frontmatter requirements ensures your Claude Skill passes the light-weight validation checklist and maintains consistent Skill discovery across projects.

Validate a SKILL.md file by checking for required YAML frontmatter, presence of clear usage instructions, and proper handling of optional resources. This light-weight validation checklist ensures your Claude Code project structure aligns with Skill discovery workflows.

Yes, you can include optional resources when authoring Claude Skills. The Skill authoring process provides guidance on optional resources handling alongside the required YAML frontmatter validation, ensuring your SKILL.md file remains well-structured and discoverable.

Your Claude Skill may not appear in Skill discovery workflows if its SKILL.md file lacks the required YAML frontmatter fields, specifically name and description. Validating your project structure and frontmatter ensures consistent team-wide discoverability.

The best way to audit existing SKILL.md files is to apply a light-weight validation checklist that checks for YAML frontmatter requirements, clear usage instructions, and optional resources handling. This ensures your Claude Code project structure aligns with Skill discovery workflows.