skill-writer

To create a well-formed SKILL.md file for Claude Code, define valid YAML frontmatter with specific metadata like dependencies and components, then structure clear, actionable instructions for the desired skill scope.

Skill discovery issues across projects often stem from invalid YAML frontmatter or improper SKILL.md structure. Validate frontmatter fields, enforce naming conventions, and ensure descriptions are specific to resolve discovery failures.

A correct Claude Code skill unit requires a SKILL.md file with valid YAML frontmatter, clear instructions, and concrete metadata. It can also include progressive disclosure files like reference.md and optional directories such as scripts or assets.

Validate YAML frontmatter for documentation skills by checking for proper syntax, ensuring required metadata fields like dependencies and components are populated, and confirming that descriptions remain specific and actionable.

Yes, you can use progressive disclosure files like examples.md and reference.md when designing skills. These optional resources support execution and learning alongside the core SKILL.md instructions.