Skill Validator

Phase 2: Structure Validation

Check the SKILL.md body structure:

1. Required Sections

   • Overview with core principle
   • "When to Use" or similar trigger section
   • Red Flags section
   • Checklist section
   • Quick Commands or Quick Patterns

2. Length Check

   • SKILL.md should be < 500 lines
   • If approaching limit, content should be in references/

3. Code Examples

   • Use ✅/❌ or checkmark/X pattern for good/bad
   • Examples should be practical and runnable

Phase 3: Reference Validation

Check the references/ directory:

1. Cited References Exist

   • Every file mentioned in SKILL.md References section exists
   • Check: references/{filename}.md

2. No Orphaned References

   • Every file in references/ is cited in SKILL.md
   • Orphaned files waste space and cause confusion

3. Naming Convention

   • Files should be {topic}.md or {topic}-patterns.md
   • Avoid {skill}-research.md pattern

Red Flags - STOP and Fix

Frontmatter Red Flags

# ❌ Has tags field (removed from spec)