bmad-index-docs

Point the Skill at the target directory and it scans all files and subdirectories, reads each file's content, and writes an index.md with organized links and 3-10 word descriptions. Files are grouped by type or subfolder and sorted alphabetically.

Request an index for your docs folder and the Skill produces a Markdown file listing every document with relative links starting with ./ and concise descriptions based on actual file contents, not just filenames.

No, hidden files starting with a dot are skipped by default. They are only included if you explicitly specify that they should be part of the index.

Generation halts if the target directory does not exist, is inaccessible, or if you lack write permissions to create index.md in that location. Verify the path exists and permissions are correct before retrying.

Yes, the Skill handles both creating a new index.md and updating an existing one. It rescans the folder contents and refreshes the listings to reflect added, removed, or changed files.