skill-docs-updater

You automate updating a markdown index from YAML frontmatter by running a skill that reads the name and description fields from each SKILL.md and regenerates the master SKILLS-INDEX.md file. This keeps the catalog synced automatically.

The best way to keep a skills index in sync after renaming files is to regenerate the index from the updated YAML frontmatter of every SKILL.md. This rebuilds the catalog with an alphabetized, concise entry per skill.

Frontmatter extraction for markdown documentation catalogs works by reading the YAML metadata blocks from each SKILL.md file to pull the name and description fields, then writing those values into a centralized SKILLS-INDEX.md.

You should regenerate the SKILLS-INDEX.md file immediately after creating a new skill, renaming an existing one, or modifying skill definitions to prevent manual drift and ensure consistency across the directory.

The skills index updater requires no external dependencies. It operates independently to read YAML frontmatter from SKILL.md files and rewrite the SKILLS-INDEX.md document within the existing skills directory.