bmad-index-docs

To generate a markdown index for a directory, the skill scans your target folder, groups similar files, reads content for concise descriptions, and writes a structured index.md with relative paths sorted alphabetically.

The best way to create an index.md is to automate directory scanning and file content analysis, which groups files by type and subdirectory to produce concise, descriptive links to each document automatically.

Automated directory indexing handles content discovery by scanning the target folder, grouping content by type and subdirectory, and reading file contents to generate concise, descriptive Markdown entries.

If the target directory for documentation indexing is missing or write-protected, the automated process halts immediately to prevent errors and ensure the index.md is only updated in accessible folders.

Yes, you can update an existing markdown documentation index automatically. The skill scans the directory and writes or updates the structured index.md, ensuring all current files are referenced without starting over.

Yes, the generated markdown index uses relative paths for all file descriptions. It sorts entries alphabetically and links to each file using paths relative to the target directory.