Skill validation process for Bosun plugin skills. Use when validating skills, checking skill quality, reviewing skill structure, or auditing skill references. Also use when creating a new Bosun skill, checking frontmatter format, validating referenced files exist, ensuring skills follow naming conventions, or auditing all skills before release. Essential for skill authors and plugin quality assurance.
Skills are Bosun's knowledge packages. Invalid skills break the plugin. This skill guides systematic validation of Bosun skills before they ship.
Core principle: Validate early, validate often. A malformed skill wastes everyone's time.
Check the YAML frontmatter at the top of SKILL.md:
Required Fields
name - Must be present, must be {purpose} formatdescription - Must be present, must include trigger phrasesForbidden Fields
tags - Removed per skill-creator specname and descriptionDescription Quality
Check the SKILL.md body structure:
Required Sections
Length Check
Code Examples
Check the references/ directory:
Cited References Exist
references/{filename}.mdNo Orphaned References
Naming Convention
{topic}.md or {topic}-patterns.md{skill}-research.md pattern# ❌ Has tags field (removed from spec)