amcos-skill-management

You validate agent skill directories by running the skills-ref validator to ensure YAML frontmatter correctness and reference integrity. This checks that required name and description fields exist in the frontmatter and a SKILL.md file is present at the skill root.

Skill reindexing in Perfect Skill Suggester (PSS) is triggered to refresh keyword extraction and co-usage relationships. It updates the discovery index so accurate skills are surfaced based on validated skill structures and metadata.

To pass skill validation, your skill directories need YAML frontmatter containing the name and description fields, along with a SKILL.md file located at the skill root. Access to the skills-ref validator is also required.

You can coordinate skill activation and discovery workflows across team agents during per-team AMCOS governance. This process uses validated skill structures and PSS reindexing to manage how skills are discovered and activated.

Skill discovery fails when skill metadata lacks proper YAML frontmatter or a root SKILL.md file. Validation checks frontmatter correctness and reference integrity, and you must trigger a PSS reindex to refresh the discovery index.