skill-writer

Design a Skill by writing SKILL.md with YAML frontmatter (name and description), a concise body following progressive disclosure, optional references, and assets. Use the standard init and package scripts to validate structure and prepare for deployment.

Frontmatter requires name and description fields in YAML format. Documentation body must stay lean using progressive disclosure—core task first, then details. References and assets integrate separately to keep the main document focused and scannable.

Break down your prompt or workflow into a structured Skill by identifying the core task, defining inputs and outputs, writing clear SKILL.md documentation with frontmatter, and packaging it with init and package scripts following standard Skill conventions.

Yes. Validation checks that YAML frontmatter contains required name and description fields, SKILL.md structure follows progressive disclosure, references are properly integrated, and all files meet packaging standards before running the package script.

Skill discovery relies on clear frontmatter, descriptive names, and proper documentation structure. Troubleshoot by verifying frontmatter completeness, ensuring SKILL.md conciseness without jargon, checking reference formatting, and confirming the standard packaging steps completed successfully.