Skill Synchronizer

To automatically update the AGENTS.md skills index, this tool scans the .agent/skills directory, extracts YAML frontmatter from each SKILL.md, and generates a Markdown table to replace the existing index section.

Extracting YAML frontmatter from Markdown files involves parsing each SKILL.md for metadata fields like name, description, and trigger. The extracted data is then formatted into a consistent Markdown table for the skills index.

The best way to keep a repository skills index synchronized is through recursive skill discovery. It reads SKILL.md files, parses YAML frontmatter, and surgically updates the AGENTS.md index without altering other project content.

Yes, you can surgically replace a specific Markdown section without breaking other content. It targets only the Available Skills Index section in AGENTS.md, preserving all surrounding text and replacing just the discovered skill metadata.

No external dependencies are required to parse YAML and synchronize the skills index. It operates independently to scan directories, read Markdown frontmatter, and update the index file.

You should run skills index synchronization immediately after skill creation or modification. This ensures CI pipelines and maintainers always reference a current, discoverable index of available agent capabilities.