skill-authoring-workflow

To convert rough PM notes into a validated SKILL.md file, use the guided authoring workflow to execute preflight, draft, tightening, validation, and integration phases that enforce frontmatter validity and repository standards.

The skill authoring workflow is a multi-phase process that transforms product management drafts into compliant skills by generating standardized SKILL.md assets, enforcing section order, metadata limits, and cross-references to pass repository validation.

Validate skill metadata and frontmatter before publishing by running automated check scripts like check-skill-metadata and test-a-skill, which verify name, description, intent, and type fields against repository limits and standards.

Yes, you can manually edit a generated SKILL.md file after using the authoring wizard, as the workflow supports manual edits alongside guided wizard and content-first creation methods to maintain quality across skills.

Repository validation checks enforced during skill authoring include frontmatter validity for required fields, section order verification, metadata limits, cross-references, and automated checks executed via scripts such as build-a-skill and find-a-skill.