Agent Skills
› terryso/open-agent-sdk-swift
› bmad-index-docs
bmad-index-docs
GitHub自动扫描指定目录，读取文件内容生成准确描述，并按类型或子目录分组，创建或更新包含所有文档链接的 index.md 索引文件。
Trigger Scenarios
用户要求创建或更新特定文件夹的文档索引
需要整理和汇总目录下的所有文档文件
Install
npx skills add terryso/open-agent-sdk-swift --skill bmad-index-docs -g -y
SKILL.md
Frontmatter
{
"name": "bmad-index-docs",
"description": "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"
}
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
Version History
- 0.12.0 Current 2026-07-24 22:34
