skill-writer

Create a SKILL.md file with YAML frontmatter at the top, including metadata fields like name, description, and version. The Skill uses a template-driven approach to enforce naming rules, required fields, and recommended multi-file layout (SKILL.md, reference.md, examples.md) for consistent skill structure.

YAML frontmatter is a key-value block enclosed in triple dashes at the SKILL.md start. skill-writer validates syntax and required fields, providing templates that show proper indentation, data types, and field ordering to avoid parsing errors.

Yes. skill-writer validates YAML frontmatter syntax and content structure in existing SKILL.md files across personal (~/.claude/skills) and project (.claude/skills) contexts, identifying missing or malformed fields without rewriting the file.

Organize skills with SKILL.md as the primary file, supplemented by reference.md for detailed documentation and examples.md for use-case demonstrations. skill-writer provides templates for each file type and enforces the multi-file layout pattern.

Skill names must follow specific conventions and descriptions require substantive content. skill-writer enforces naming rules and validates description quality during skill creation to ensure consistency and clarity across the Skills ecosystem.

skill-writer provides templates and step-by-step guidance that handle markdown formatting and YAML syntax, so you can focus on skill logic and documentation content without deep markup language expertise.