bmad-index-docs

Generate or update an index.md with relative links for a target folder.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/Yukine5377/common --skill bmad-index-docs-yukine5377
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-index-docs
Source: https://github.com/Yukine5377/common/tree/main/.cursor/skills/bmad-index-docs
Command: npx skills add https://github.com/Yukine5377/common --skill bmad-index-docs-yukine5377

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generates or updates an index.md that references all docs in the folder, enabling quick navigation.

Core Features & Use Cases

  • Scan target directory to enumerate files and subfolders
  • Group content by type and location
  • Produce a readable index.md with relative links to files

Quick Start

Create or update the index.md for a target folder to generate a current directory index.

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 docs folder?

To automatically generate a markdown index for your docs folder, use this tool to scan the target directory and produce a readable index.md with relative links to all files and subfolders.

What is the best way to keep documentation indexes updated as files change?

Keeping documentation indexes updated as files change is done by re-running the directory scan to regenerate or update the existing index.md, ensuring quick navigation and up-to-date references for all current items.

Can I group documentation files by type when generating a directory index?

Yes, you can group documentation files by type when generating a directory index. The tool reads the target folder, groups content by type and location, and writes these categorized sections into the index.md.

Does the generated index.md use relative paths for file navigation?

Yes, the generated index.md uses relative paths for file navigation. This ensures that the links to your documentation files and subfolders remain valid regardless of the root folder's location.

What's the best way to organize markdown files for quick reference in a project?

Organizing markdown files for quick reference in a project is best achieved by generating an index.md at the root, grouping items by type, and providing relative links to enable immediate navigation.

How do I update an existing index.md without losing my manual edits?

Updating an existing index.md scans the directory and writes or updates the file in the root to reflect current changes. To preserve manual edits, maintain them outside the generated index structure.