bmad-index-docs

Generates and updates index.md files by scanning directories and summarizing document contents.

Updated Mar 25, 2026
One-click install
npx skills add https://github.com/JingyiWng/databricks_ai_dev_kit_price_watcher --skill bmad-index-docs-jingyiwng
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-index-docs
Source: https://github.com/JingyiWng/databricks_ai_dev_kit_price_watcher/tree/main/_bmad/core/skills/bmad-index-docs
Command: npx skills add https://github.com/JingyiWng/databricks_ai_dev_kit_price_watcher --skill bmad-index-docs-jingyiwng

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually building and maintaining an index of documentation files is time‑consuming and error‑prone. This Skill automates the creation and updating of a comprehensive index.md for any folder.

Core Features & Use Cases

  • Directory Scanning: Lists all files and subfolders in the target location.
  • Content‑Based Descriptions: Reads each file to generate concise, accurate summaries.
  • Structured Index Generation: Writes or updates index.md with organized listings, grouped by type or subdirectory.
  • Use Case: Quickly produce an up‑to‑date navigation page for a project's docs/ folder, ensuring collaborators can find relevant files instantly.

Quick Start

Generate an index for the './docs' directory.

Frequently Asked Questions about bmad-index-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically generate a markdown index for my documentation folder?▼

Generating an index.md involves scanning a target directory, reading each documentation file to produce concise summaries, and writing an organized listing grouped by type or subfolder.

How does automated documentation indexing handle folder scanning and descriptions?▼

Automated documentation indexing scans the target directory to list files, reads each file to generate a concise content description, and groups these entries by type or subfolder in the output.

What is the best way to update an existing index.md without manual entry?▼

Updating an index.md without manual entry requires an automated tool that re-scans the target directory, validates file existence, and modifies the markdown file to reflect current documentation.

Do I need specific folder permissions to create an automated index of markdown files?▼

Creating an automated index of markdown files requires read access to the target folder to scan files and write permissions to create or modify the index.md file.

Can I group documentation files by subfolder when generating an index?▼

When generating an index, documentation files can be grouped by type or subdirectory, producing a structured markdown index that organizes listings logically for collaborators.

Why does my documentation index need file existence validation before proceeding?▼

Documentation index generation requires file existence validation to ensure the tool only processes and references current files, preventing broken links and errors when writing the structured markdown index.