Agent skill

Bmad Document Project

by delorenj in delorenj/mcp-server-trello

Document brownfield projects for AI context. An agent skill from delorenj/mcp-server-trello.

MITAuto-check passedDevelopment

Install Bmad Document Project

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

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

GitHub CLI
$ gh skill install delorenj/mcp-server-trello bmad-document-project --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/.agent/skills/bmad-document-project .claude/skills/bmad-document-project && 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-document-project
GitHub stars
445
Used in
5 other repos
Token cost
~665 tokens
SKILL.md length
293 words
Files
14
Skills in repo
64
Repo updated
First seen
Licence
MIT

At a glance

Document brownfield projects for AI context. An agent skill from delorenj/mcp-server-trello.

  • Works in 6 steps: Resolve the Workflow Block → Execute Prepend Steps → Load Persistent Facts → …
  • The user says document this project
  • SKILL.md covers Conventions, On Activation and Execution
  • Calls python3

What it does

Bmad Document Project is an agent skill from delorenj/mcp-server-trello. Document brownfield projects for AI context. Use when the user says "document this project" or "generate project docs"

Its SKILL.md is about 670 tokens, which your agent loads only when the skill is triggered. The skill folder holds 15 other files (for example `checklist.md`, `instructions.md` and `templates/deep-dive-template.md`).

It sits in Development, covering Project scaffolding. 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

  • The user says document this project
  • Generate project docs

Example prompts

  • “document this project”
  • “generate project docs”
  • “/bmad-document-project”

Requirements

  • Python 3

Workflow steps

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

  1. Resolve the Workflow Block
  2. Execute Prepend Steps
  3. Load Persistent Facts
  4. Load Config
  5. Greet the User
  6. Execute Append Steps

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

    Shell commands in SKILL.md call:

    • python3

    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 Document Project loads about 665 tokens when it runs. Until then it costs about 35 tokens; SKILL.md has 293 words of instructions outside code blocks.

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

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). 293 words, ~665 tokens.

Download SKILL.mdSave it as .claude/skills/bmad-document-project/SKILL.md (or your agent's skills folder). This skill also uses 13 other files; get the full folder from GitHub.
name
bmad-document-project
description
Document brownfield projects for AI context. Use when the user says "document this project" or "generate project docs"

Document Project Workflow

Goal: Document brownfield projects for AI context.

Your Role: Project documentation specialist.

Conventions

  • Bare paths (e.g. instructions.md) resolve from the skill root.
  • {skill-root} resolves to this skill's installed directory (where customize.toml lives).
  • {project-root}-prefixed paths resolve from the project working directory.
  • {skill-name} resolves to the skill directory's basename.

On Activation

Step 1: Resolve the Workflow Block

Run: python3 {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --key workflow

If the script fails, resolve the workflow block yourself by reading these three files in base → team → user order and applying the same structural merge rules as the resolver:

  1. {skill-root}/customize.toml — defaults
  2. {project-root}/_bmad/custom/{skill-name}.toml — team overrides
  3. {project-root}/_bmad/custom/{skill-name}.user.toml — personal overrides

Any missing file is skipped. Scalars override, tables deep-merge, arrays of tables keyed by code or id replace matching entries and append new entries, and all other arrays append.

Step 2: Execute Prepend Steps

Execute each entry in {workflow.activation_steps_prepend} in order before proceeding.

Step 3: Load Persistent Facts

Treat every entry in {workflow.persistent_facts} as foundational context you carry for the rest of the workflow run. Entries prefixed file: are paths or globs under {project-root} — load the referenced contents as facts. All other entries are facts verbatim.

Step 4: Load Config

Load config from {project-root}/_bmad/bmm/config.yaml and resolve:

  • Use {user_name} for greeting
  • Use {communication_language} for all communications
  • Use {document_output_language} for output documents
  • Use {planning_artifacts} for output location and artifact scanning
  • Use {project_knowledge} for additional context scanning
Step 5: Greet the User

Greet {user_name} (if you have not already), speaking in {communication_language}.

Step 6: Execute Append Steps

Execute each entry in {workflow.activation_steps_append} in order.

Activation is complete. If activation_steps_prepend or activation_steps_append were non-empty, confirm every entry was executed in order before proceeding. Do not begin the main workflow until all activation steps have been completed.

Execution

Read fully and follow: ./instructions.md

© 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

SKILL.md and 13 other files in .agent/skills/bmad-document-project of delorenj/mcp-server-trello.

  • SKILL.md
  • checklist.md
  • customize.toml
  • documentation-requirements.csv
  • instructions.md
  • templates/deep-dive-template.md
  • templates/index-template.md
  • templates/project-overview-template.md
  • templates/project-scan-report-schema.json
  • templates/source-tree-template.md
  • workflows/deep-dive-instructions.md
  • workflows/deep-dive-workflow.md
  • workflows/full-scan-instructions.md
  • workflows/full-scan-workflow.md

Open the folder on GitHubat commit 737292f

Used in 5 other repositories

We found 11 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 Document Project 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 Document Project compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bmad Document Project this skilldelorenj/mcp-server-trello4455 repos~665Automated safety check: PassMIT
Nx Generatenomcopter/react-mosaic4.8k7 repos~1.9kAutomated safety check: PassCustom licence
PonytailDavidObando/gsharp5648 repos~1.7kAutomated safety check: PassMIT
Run Nx Generatornrwl/nx29k2 repos~592Automated safety check: NotesMIT
Conductor Setupgemini-cli-extensions/conductor3.8k—~4.2kAutomated safety check: PassApache-2.0
Mirage VFS Adapter Authoringstrukto-ai/mirage3.7k—~2.5kAutomated safety check: PassApache-2.0

Similar skills

  • Nx Generate

    nomcopter/react-mosaic

    Generate code using nx generators. An agent skill from nomcopter/react-mosaic.

    4.8k GitHub starsUsed in 7 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Ponytail

    DavidObando/gsharp

    Forces the laziest solution that actually works, simplest, shortest, most minimal.

    564 GitHub starsUsed in 8 repos~1.7k tokens
    DevelopmentAuto-check passed
  • Run Nx generators with prioritization for workspace-plugin generators.

    29k GitHub starsUsed in 2 repos~592 tokens
    DevelopmentAuto-check: notes
  • Conductor Setup

    gemini-cli-extensions/conductor

    Scaffolds the project and sets up the Conductor environment.

    3.8k GitHub stars~4.2k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Builds or extends a custom Mirage virtual filesystem adapter for an API, database, object store or app data, with a working mount configuration and filesystem tests.

    3.7k GitHub stars~2.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Enforces this repository's TypeScript backend module architecture under server/: feature folders, barrel exports, and where shared types and utilities belong.

    14k GitHub stars~1.2k tokensUpdated yesterday
    DevelopmentAuto-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 15 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 15 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

Categories

Questions about Bmad Document Project

What does Bmad Document Project do?

Document brownfield projects for AI context. An agent skill from delorenj/mcp-server-trello. Bmad Document Project is an agent skill from delorenj/mcp-server-trello. Document brownfield projects for AI context.

When should I use Bmad Document Project?

Bmad Document Project fits situations like: the user says document this project; generate project docs.

How do I install Bmad Document Project in Claude Code?

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

How do I install Bmad Document Project in Codex?

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

Can I use Bmad Document Project 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-document-project -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-document-project, .gemini/skills/bmad-document-project, .github/skills/bmad-document-project and .opencode/skills/bmad-document-project in your project.

What does Bmad Document Project need to run?

Going by SKILL.md and its folder, Bmad Document Project needs the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Bmad Document Project 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 Document Project 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 Document Project use?

Bmad Document Project 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 Document Project use?

About 665 tokens (SKILL.md is roughly 2.7k 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 Document Project?

Skills that share tags, products or a category with Bmad Document Project: Nx Generate (nomcopter/react-mosaic, 4.8k stars), Ponytail (DavidObando/gsharp, 564 stars), Run Nx Generator (nrwl/nx, 29k stars) and Conductor Setup (gemini-cli-extensions/conductor, 3.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bmad Document Project?

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.