Agent skill

Bmad Index Docs

by delorenj in delorenj/mcp-server-trello

Generates or updates an index.md to reference all docs in the folder.

MITAuto-check passed

Install Bmad Index Docs

skills CLI
$ npx skills add delorenj/mcp-server-trello --skill bmad-index-docs -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install delorenj/mcp-server-trello bmad-index-docs --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/delorenj/mcp-server-trello.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/bmad-index-docs .claude/skills/bmad-index-docs && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
bmad-index-docs
GitHub stars
445
Used in
5 other repos
Token cost
~411 tokens
SKILL.md length
143 words
Files
1
Skills in repo
64
Repo updated
First seen
Licence
MIT

At a glance

Generates or updates an index.md to reference all docs in the folder.

  • Works in 4 steps: Scan Directory → Group Content → Generate Descriptions → …
  • User requests to create
  • SKILL.md covers EXECUTION, OUTPUT FORMAT, HALT CONDITIONS and VALIDATION
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Bmad Index Docs is an agent skill from delorenj/mcp-server-trello. 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

Its SKILL.md is about 410 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: A Model Context Protocol (MCP) server that provides tools for interacting with Trello boards. The licence is MIT.

When your agent uses it

  • User requests to create
  • Update an index of all files in a specific folder

Example prompts

  • “Use the bmad-index-docs skill to generate or updates an index.md to reference all docs in the folder”
  • “/bmad-index-docs”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Scan Directory
  2. Group Content
  3. Generate Descriptions
  4. Create/Update Index

What it can do on your machine

Read from SKILL.md and the folder at commit 737292f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Bmad Index Docs loads about 411 tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 143 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~42
When it runs · the whole SKILL.md, loaded when a task matches
~411

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from delorenj/mcp-server-trello at commit 737292f, republished under its MIT licence (© delorenj). 143 words, ~411 tokens.

Download SKILL.mdSave it as .claude/skills/bmad-index-docs/SKILL.md (or your agent's skills folder).
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

markdown
# 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

© delorenj, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/bmad-index-docs of delorenj/mcp-server-trello.

Open the folder on GitHubat commit 737292f

Used in 5 other repositories

We found 10 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 5 other GitHub owners. This page covers the copy in delorenj/mcp-server-trello, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Bmad Index Docs next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Bmad Index Docs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bmad Index Docs this skilldelorenj/mcp-server-trello4455 repos~411Automated safety check: PassMIT
Update Markdown File Indexgithub/awesome-copilot40k1 repos~668Automated safety check: PassMIT
Generatealirezarezvani/claude-skills28k1 repos~1.1kAutomated safety check: PassMIT
Indexabilitythedaviddias/Front-End-Checklist74k—~814Automated safety check: PassMIT
Index Refreshpaperclipai/paperclip99k—~994Automated safety check: PassMIT
Fal Generatenexu-io/open-design100k—~306Automated safety check: PassApache-2.0

Similar skills

  • Update Markdown File Index

    github/awesome-copilot

    Official

    Update a markdown file section with an index/table of files from a specified folder.

    40k GitHub starsUsed in 1 repo~668 tokens
    Documents & OfficeAuto-check passed
  • Generate

    alirezarezvani/claude-skills

    Generate Playwright tests. An agent skill from alirezarezvani/claude-skills.

    28k GitHub starsUsed in 1 repo~1.1k tokens
    Testing & QAAuto-check passed
  • Indexability

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing a site for accidental noindex directives, investigating why important pages are not appearing in Google Search, or reviewing CMS settings that control indexing…

    74k GitHub stars~814 tokensUpdated 3 days ago
    Marketing & SEOAuto-check passed
  • Index Refresh

    paperclipai/paperclip

    A skill your agent uses when an LLM Wiki operation issue requests an index refresh.

    99k GitHub stars~994 tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Fal Generate

    nexu-io/open-design

    Generate images and videos using fal.ai AI models. An agent skill from nexu-io/open-design.

    100k GitHub stars~306 tokensUpdated today
    Media & CreativeAuto-check passed
  • Video Generation

    bytedance/deer-flow

    Generates short videos from a structured JSON prompt, optionally guided by a reference image used as the first or last frame.

    84k GitHub starsUsed in 3 repos~1.4k tokens
    Media & CreativeAuto-check passed

More from delorenj/mcp-server-trello

All 64 skills in this repo
  • Bmad Distillator

    delorenj/mcp-server-trello

    Lossless LLM-optimized compression of source documents. An agent skill from delorenj/mcp-server-trello.

    445 GitHub starsUsed in 5 repos~2.2k tokens
    Auto-check passed
  • Bmad Deep Recon

    delorenj/mcp-server-trello

    Decision-grade research, three ways: draft a deep-research prompt for the user to run in their own tool (ChatGPT, Gemini, Grok, Perplexity, …), process a finished research report — file it, distill…

    445 GitHub stars~2.3k tokensUpdated 16 days ago
    Auto-check passed
  • Bmad Customize

    delorenj/mcp-server-trello

    Authors and updates customization overrides for installed BMad skills.

    445 GitHub starsUsed in 3 repos~1.7k tokens
    Auto-check passed
  • Openai Docs

    delorenj/mcp-server-trello

    A skill your agent uses when the user asks how to build with OpenAI products or APIs, asks about Codex itself or choosing Codex surfaces, needs up-to-date official documentation with citations, help…

    445 GitHub stars~5.7k tokensUpdated 16 days ago
    Auto-check passed
  • Bmad Architecture

    delorenj/mcp-server-trello

    Produce the architecture: a lean spine of invariants that keeps everything built from it consistent, projected into whatever format the work needs.

    445 GitHub starsUsed in 1 repo~3.5k tokens
    Auto-check passed
  • Bmad Brainstorming

    delorenj/mcp-server-trello

    Facilitate a brainstorming session using diverse creative techniques.

    445 GitHub starsUsed in 1 repo~2.4k tokens
    Auto-check passed

Questions about Bmad Index Docs

What does Bmad Index Docs do?

Generates or updates an index.md to reference all docs in the folder. Bmad Index Docs is an agent skill from delorenj/mcp-server-trello.md to reference all docs in the folder.

When should I use Bmad Index Docs?

Bmad Index Docs fits situations like: user requests to create; update an index of all files in a specific folder.

How do I install Bmad Index Docs in Claude Code?

Run `npx skills add delorenj/mcp-server-trello --skill bmad-index-docs -a claude-code`. Or copy the skill folder (.agents/skills/bmad-index-docs in delorenj/mcp-server-trello) into .claude/skills/bmad-index-docs in your project. Claude Code loads it when a task matches its description.

How do I install Bmad Index Docs in Codex?

Run `npx skills add delorenj/mcp-server-trello --skill bmad-index-docs -a codex`. Or copy the skill folder (.agents/skills/bmad-index-docs in delorenj/mcp-server-trello) into .agents/skills/bmad-index-docs in your project. Codex loads it when a task matches its description.

Can I use Bmad Index Docs in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add delorenj/mcp-server-trello --skill bmad-index-docs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bmad-index-docs, .gemini/skills/bmad-index-docs, .github/skills/bmad-index-docs and .opencode/skills/bmad-index-docs in your project.

What does Bmad Index Docs need to run?

SKILL.md names no scripts, command-line tools or credentials: Bmad Index Docs is instructions for the agent only.

Does Bmad Index Docs access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Bmad Index Docs safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Bmad Index Docs use?

Bmad Index Docs is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Bmad Index Docs use?

About 411 tokens (SKILL.md is roughly 1.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Bmad Index Docs?

Skills that share tags, products or a category with Bmad Index Docs: Update Markdown File Index (github/awesome-copilot, 40k stars), Generate (alirezarezvani/claude-skills, 28k stars), Indexability (thedaviddias/Front-End-Checklist, 74k stars) and Index Refresh (paperclipai/paperclip, 99k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bmad Index Docs?

delorenj (a GitHub user) maintains it in delorenj/mcp-server-trello, which has 445 GitHub stars. The repository holds 64 skills in this directory. The repository was last updated on September 23, 2026.

Source: delorenj/mcp-server-trello on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.