bmad-brainstorming skill (BMad Method): run a brainstorm with 108 techniques

bmad-brainstorming makes your agent coach a brainstorming session that pushes you past the obvious ideas.

Installs: 13.4K; on skills.sh
Stars: 54.9K; on GitHub
Files: 15; besides SKILL.md
Updated: Nov 2026; last repo commit

bmad-brainstorming is a skill in the BMad Method. Say "help me brainstorm" or "help me ideate" and the agent asks what you are brainstorming and why. You then pick one of three roles for it: Facilitator (it never supplies ideas, only questions and constraints), Creative Partner (it plays along and trades ideas) or Ideate for me (it runs the whole session and shows you the result).

Techniques come from a bundled library of 108 in 13 categories, which you can browse on a local HTML page and paste back into the chat. Every idea is logged to a session file, so you can resume later. At the end it writes a synthesis. In Ideate for me mode it also produces an HTML keepsake automatically; in the other modes the keepsake and a short intent doc are opt-in. It needs uv and a BMad-initialised project.

Good for

Founders and product people who want more and better ideas on a topic
Teams feeding ideas into a BMad product brief or PRD
Anyone who wants an agent that asks questions instead of handing over a list

Install bmad-brainstorming

Claude Code

Copy this prompt.

Install the bmad-brainstorming skill in Claude Code. Run this command:

/plugin marketplace add bmad-code-org/bmad-plugins

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires uv, Node.js 20.12 or newer, Python 3.10 or newer.

The BMAD-METHOD README calls the V7 line a preview alpha with breaking changes between updates. It also lists a stable v6.12 line installed with npx bmad-method install, which this skill page does not cover. The README names the standalone plugin bmad-core-tools, while the bmad-plugins marketplace lists it as bmad-toolbox.

From the project README. Source.

What's in the skill

When it loads

Facilitate a brainstorming session using diverse creative techniques. Use when the user says 'help me brainstorm' or 'help me ideate'

Sections in SKILL.md

Overview
Conventions
On Activation
Framing — hold this the whole run
Run a Session
Choosing Techniques
Converging
Resuming
Wrap-Up

Key facts

Author: bmad-code-org (GitHub account that owns the repo)
Source repo: bmad-code-org/bmad-method
Installs on skills.sh: 13,376 as of 2026-11-02
GitHub stars: 54,859 (whole repo) as of 2026-11-02
Last repo commit: 2026-11-01
Files: 16 files including SKILL.md (8 reference files, brain-methods.csv, a selector HTML page, an icons file, 2 toml files, brain.py and its test)
skills.sh audits: Gen Agent Trust Hub warn, Socket pass, Snyk pass
Part of: BMad Method, plugin bmad-toolbox (8 standalone skills in the bmad-plugins marketplace)
Needs: uv, and a BMad-initialised project (_bmad/ folder)
Technique library: 108 techniques in 13 categories (counted from brain-methods.csv)
License: MIT, stated in the BMAD-METHOD README (GitHub does not detect a license for the repo)

What it includes

The agent never supplies ideas; it asks, provokes and sets constraints.
Facilitator mode
The agent facilitates and also trades ideas, tagged by who had them.
Creative Partner mode
The agent runs the whole session itself and shows the result.
Files · Ideate for me mode
Local HTML page to pick a stance and techniques, then copy a prompt back into chat.
The agent tries to open assets/brain-selector.html in your browser. It may regenerate the page with brain.py if you customised the catalog.
Runs code · Technique composer page
Every idea and decision is appended to a .memlog.md file so you can resume.
Writes use memlog.py from the _bmad/scripts folder through uv run.
Runs code · Session memlog
Optional phase to narrow, prioritize and decide, using references/converge.md.
Converge
Picks up an unfinished brainstorm-* session found in the output folder.
Files · Resume
Synthesis, then optional HTML keepsake, intent doc or other formats from the memlog.
Write · Wrap-up and artifacts
For machine callers only: the agent brainstorms alone from a topic payload.
Files · Headless mode

From the official docs

Permissions

Low risk

The skill runs local uv scripts and writes session files into your project. It can also open a bundled HTML page in your browser.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It runs uv scripts and writes files
SKILL.md runs resolve_customization.py, resolve_config.py and memlog.py from _bmad/scripts, and brain.py from the skill folder, through uv run. It writes a memlog and any artifacts you request into the output folder. github.com
It tries to open a local HTML page
The composer page is opened with open, xdg-open or start. Its copy button writes your selection to the clipboard. github.com
The plugin route adds 8 skills
The bmad-toolbox plugin in the bmad-plugins marketplace holds 8 skills, including bmad and bmad-brainstorming. The tree shows no hooks or MCP config in it, only plugin metadata. github.com

Technical details

Scopes	Your BMad output folder _bmad/scripts in your project

Questions

How do I install bmad-brainstorming?

Use the install box above. The skill calls scripts in your project's _bmad/ folder. Install the BMad Method and ask its bmad skill to run bmad setup. SKILL.md also names a single-skill command for the bmad skill if setup is missing.

What are the three modes?

Facilitator: the agent never supplies ideas. Creative Partner: it facilitates and trades ideas with you. Ideate for me: it runs the whole session and shows you the result. You choose one at the start, or it follows how you asked.

Where do my ideas go?

Into a .memlog.md file in a brainstorm-<topic> folder under your BMad output folder. SKILL.md calls it the session's memory. It is also what a resume reloads and what the final synthesis and artifacts are built from.

What do I get at the end?

A synthesis of your ideas and the connections between them. In Ideate for me mode the imaginative HTML keepsake is produced automatically. In the other modes you can ask for it, for a short intent document that can feed bmad-product-brief or bmad-prd, or for other formats such as a pitch or one-pager.

Does it need an API key?

The skill does not mention one. It runs local uv scripts, and the bundled brain.py imports only Python standard library modules.

Is bmad-brainstorming safe to install?

It runs local uv scripts, writes session files to your project's output folder and can open an HTML page in your browser. Read the safety notes below, and review what BMad setup adds to your project.

Information

updated Nov 2, 2026

Repository: bmad-code-org/bmad-method
Folder: skills/bmad-brainstorming

bmad-code-org/bmad-method skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 8

BMAD-METHOD README · github.com
bmad-plugins README · github.com
bmad-brainstorming SKILL.md · github.com
finalize.md · github.com
bmad-brainstorming brain-methods.csv · github.com
bmad-brainstorming on skills.sh · skills.sh
brain.py · github.com
toolbox plugin · github.com