bmad-index-docs

To auto-generate folder documentation indexes, this skill reads individual file contents to produce accurate short descriptions, organizing entries by file type and subdirectory with alphabetical sorting and relative path formatting.

Cataloging markdown files in a project knowledge base is done by scanning target folders and generating an index.md file that groups resources by type and subdirectory, creating 3-10 word content-aware descriptions for easy navigation.

Content-aware index generation works by reading the actual contents of each file in a target directory, rather than just filenames, to extract accurate short descriptions for the catalog entries in the index.md file.

Yes, you can organize file catalog entries by subdirectory and file type. The generated index.md automatically groups files into these categories and enforces alphabetical sorting within each group for structured navigation.

Auto-indexing both generates and updates index.md files to ensure directory listings reflect current file resources. It reads file contents and applies relative path formatting and alphabetical sorting per defined validation rules to maintain accuracy.

No external dependencies are required to generate folder documentation indexes. The skill operates independently to read file contents, produce short descriptions, and organize directory listings by file type and subdirectory.