bmad-index-docs

To automatically generate a markdown index for a documentation folder, this skill scans the target directory, reads file contents to produce 3–10 word descriptions, and writes an index.md with grouped, alphabetized relative links.

Content-aware docs index generation works by scanning visible files and subfolders in a directory, reading each file's actual purpose, and creating concise 3–10 word summaries grounded in those contents for the index.md file.

Yes, you can update an existing index.md after adding new markdown files by running the skill to refresh the directory index, which re-scans the folder and rewrites the landing page with current grouped, alphabetized links.

The best way to organize docs navigation for subdirectories is to use automated index generation, which groups folder entries including subdirectories, alphabetizes them, and writes correct relative ./ links for easy navigation.

Yes, directory scanning for index generation skips hidden files by default to ensure the index.md only references visible documents and relevant subfolders within the target documentation folder.

If the target folder is not writable when generating an index, the process halts immediately to prevent errors, ensuring the index.md file can only be created or updated in directories with proper write permissions.