skill-category-guard

To keep categorization synchronized, enforce a mandatory primary category in SKILL.md, verify it maps to an approved slug in agents/openai.yaml, and run governance checks to update INDEX.md. This prevents search inefficiencies and boundary drift.

Fix miscategorized skills by validating alignment across SKILL.md, agents/openai.yaml, and INDEX.md. Apply remediation steps for drift during creation or boundary migrations to prevent cross-domain category conflicts.

Skill index synchronization is the governance process of aligning skill metadata across SKILL.md, agents/openai.yaml, and INDEX.md. You need it when creating new skills, migrating boundaries, or fixing miscategorized skills to maintain consistent searchability.

Yes, it applies to new skill creation, boundary migrations, and fixes for miscategorized skills. It enforces mandatory categories and provides remediation steps to resolve any alignment drift across your configuration files.

The best way to enforce consistent skill categorization is to mandate a primary category in SKILL.md, map it to an approved slug, and run automated governance checks that synchronize the index and prompts across agents/openai.yaml and INDEX.md.

Your skill index drifts because Valley MAS teams often modify skills without enforcing consistent categorization. Without mandatory governance checks mapping categories across SKILL.md, agents/openai.yaml, and INDEX.md, search inefficiencies and boundary drift occur.