skill-authoring-workflow

To convert rough notes into a compliant SKILL.md file, use a guided authoring workflow that drafts required frontmatter and sections from raw material, then runs metadata and trigger validations to ensure repository compliance.

Frontmatter validation checks for required metadata fields like name, description, intent, and type, enforces correct section ordering, verifies metadata limits, and runs cross-reference checks to ensure repository standards are met.

To prevent duplicate skills when authoring workflow content, run a preflight deconfliction scan that identifies overlapping or existing skills in the repository before you draft new material.

Yes, you need Python3, Bash, and Zip installed in your environment to execute the repository scripts, run the draft-to-validate pipeline, and package the compliant skill files.

The best way to update existing skills without breaking repo standards is running a preflight and validation workflow that enforces frontmatter validity, section order, and cross-references before commit.

Skill validation fails after updating frontmatter when required fields like name, description, intent, or type are missing, exceed metadata limits, or violate enforced section order and cross-reference checks.