Bmad index docs

Skill armelhbobdad/oh-my-skills/.claude/skills/bmad-index-docs

Curated collection of agentskills.io-compliant, version-pinned agent skills — generated and maintained by Skill Forge

Install

npx -y skills add armelhbobdad/oh-my-skills --skill bmad-index-docs

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

7 stars7 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Generates or updates an index.md to reference all docs in the folder. Use if user requests to create or update an index of all files in a specific folder

SKILL.md

1.6 KB, as published. Nobody here has run it

Index Docs

Goal: Generate or update an index.md to reference all docs in a target folder.

EXECUTION

Step 1: Scan Directory

List all files and subdirectories in the target location

Step 2: Group Content

Organize files by type, purpose, or subdirectory

Step 3: Generate Descriptions

Read each file to understand its actual purpose and create brief (3-10 word) descriptions based on the content, not just the filename

Step 4: Create/Update Index

Write or update index.md with organized file listings

OUTPUT FORMAT

# Directory Index

## Files

- **[filename.ext](./filename.ext)** - Brief description
- **[another-file.ext](./another-file.ext)** - Brief description

## Subdirectories

### subfolder/

- **[file1.ext](./subfolder/file1.ext)** - Brief description
- **[file2.ext](./subfolder/file2.ext)** - Brief description

### another-folder/

- **[file3.ext](./another-folder/file3.ext)** - Brief description

HALT CONDITIONS

HALT if target directory does not exist or is inaccessible
HALT if user does not have write permissions to create index.md

VALIDATION

Use relative paths starting with ./
Group similar files together
Read file contents to generate accurate descriptions - don't guess from filenames
Keep descriptions concise but informative (3-10 words)
Sort alphabetically within groups
Skip hidden files (starting with .) unless specified