skill-authoring-workflow

To turn rough notes into a compliant SKILL.md file, use a guided authoring workflow that automates drafting, enforces frontmatter correctness, validates section order, and ensures catalog integration before publishing.

Frontmatter validation works by checking that required fields like name, description, intent, and type are present and correctly formatted, ensuring the skill asset passes repository metadata checks before publishing.

The best way to preflight validate a skill is to run repo-native validation scripts like test-a-skill.sh and check-skill-metadata.py, which verify frontmatter correctness, section order, and trigger compliance before catalog integration.

Yes, the skill authoring workflow supports adding new skills directly to the catalog by using the repo-native add-a-skill.sh script, which integrates the validated SKILL.md file into the repository catalog.

Yes, you can use build-a-skill.sh to draft a skill from workshop content and prompts, as the authoring workflow transforms half-baked inputs into a structured SKILL.md file ready for validation.

A skill fails repository validation after updating frontmatter when required fields are missing, section order is incorrect, or metadata triggers do not pass the check-skill-triggers.py and check-skill-metadata.py scripts.