skill-writer

To write a SKILL.md file, you need valid YAML frontmatter with required name, description, and metadata fields. This skill generates registry-ready frontmatter and structures task-oriented instructions so agents can discover, load, and follow them without ambiguity.

Correct agent skill metadata combines valid YAML frontmatter for discovery and indexing with task-oriented markdown sections that agents can act on immediately. This includes clear when-to-use sections, practical examples, and safety review requirements for self-contained skill directories.

Yes, you can refactor messy drafts into valid skills by restructuring markdown content and validating YAML frontmatter. This skill reviews and improves descriptions, examples, and tips while ensuring the output meets registry expectations for component detection and safety review.

The best way to structure workflow guides and CLI references is by selecting the right section pattern for each type within your SKILL.md. This skill helps choose appropriate patterns for CLI references, workflow guides, and language or framework skills to ensure agent consumption.

Yes, you need specific frontmatter fields to pass registry validation. Required fields include name, description, and metadata that satisfy discovery, indexing, component detection, and safety review requirements for self-contained skill directories.