bmad-index-docs

To generate an index.md for a documentation folder, this skill scans your directory contents, reads each file to produce accurate summaries, and builds a structured index grouped by type or subdirectory with relative links in alphabetical order.

Yes, you can create content-aware summaries for markdown files by having the skill read each file's actual content and generate short, accurate descriptions for every entry listed in the final directory index.

The best way to organize mixed file trees into a navigable documentation index is scanning the target folder, grouping entries by type or subdirectory, and outputting relative links in alphabetical order.

Yes, this directory indexing approach works for shared reference spaces by scanning all subdirectories, grouping files logically, and creating a clean index.md that provides organized navigation for the entire folder.

To update an existing index.md with newly added documents, the skill re-scans the target directory, reads the new files for summaries, and refreshes the entry page while maintaining alphabetical order and relative links.