skill-authoring-workflow

Skill authoring automation enforces frontmatter compliance by validating metadata limits, section order, and cross-reference resolution during the creation and updating of Product Management skills. This guided workflow ensures your generated SKILL.md files are publish-ready.

To turn raw product strategy notes into a validated SKILL.md file, use the content-first approach via the add-a-skill.sh script. This workflow guides content generation and applies strict validation checks to ensure your material is compliant and structured correctly.

Yes, you can create a new skill from scratch using the guided wizard build-a-skill.sh. This workflow automation script helps you generate compliant content and integrate it directly into the repository documentation without needing existing material.

The skill validation process checks for correct section order, valid frontmatter, metadata limits, and cross-reference resolution. These strict conformance checks ensure your Product Management skills meet all repository documentation requirements before publishing.

Use the content-first approach with add-a-skill.sh when you have existing material or raw notes to transform. Use the build-a-skill.sh guided wizard when starting a new skill from scratch and you need step-by-step content generation and structure guidance.

When updating existing skills, the workflow enforces strict compliance checks for frontmatter validity and section order. Limitations include adhering to metadata limits and ensuring cross-reference resolution passes validation before your iterative refinements can be integrated into the repository.