Agent skill

Bmad Brainstorm

by aj-geddes in aj-geddes/claude-code-bmad-skills

Facilitates structured ideation sessions using proven brainstorming techniques (SCAMPER, SWOT, 5 Whys, Mind Mapping, Six Thinking Hats, Reverse Brainstorming, Starbursting, Brainwriting).

Custom licenceAuto-check: notesAgent Workflows

Install Bmad Brainstorm

skills CLI
$ npx skills add aj-geddes/claude-code-bmad-skills --skill bmad-brainstorm -a claude-code

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

GitHub CLI
$ gh skill install aj-geddes/claude-code-bmad-skills bmad-brainstorm --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/aj-geddes/claude-code-bmad-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/bmad-planning-orchestrator/skills/bmad-brainstorm .claude/skills/bmad-brainstorm && 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-brainstorm
GitHub stars
488
Token cost
~1.8k tokens
SKILL.md length
645 words
Files
4 (incl. scripts)
Skills in repo
20
Repo updated
First seen
Licence
Custom licence

At a glance

Facilitates structured ideation sessions using proven brainstorming techniques (SCAMPER, SWOT, 5 Whys, Mind Mapping, Six Thinking Hats, Reverse Brainstorming, Starbursting, Brainwriting).

  • Works in 10 steps: Gather context — Ask: topic/problem,… → Read project context — Load… → Select techniques — Choose 2-4… → …
  • The user says: brainstorm
  • SKILL.md covers Three Intents, Technique Menu, Session Workflow and Script Utilities, plus 4 more sections
  • Runs Shell scripts from its folder; calls bash

What it does

Bmad Brainstorm is an agent skill from aj-geddes/claude-code-bmad-skills. Facilitates structured ideation sessions using proven brainstorming techniques (SCAMPER, SWOT, 5 Whys, Mind Mapping, Six Thinking Hats, Reverse Brainstorming, Starbursting, Brainwriting). Produces a brainstorming-report.md of organized ideas and actionable insights. Operates in three intents: Create (new session), Update (add techniques or deepen coverage), Validate (confirm insights align with project goals). Use when the user says: "brainstorm", "ideate", "generate ideas", "explore options", "SCAMPER", "SWOT…

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts (for example `scripts/scamper-prompts.sh`, `scripts/swot-template.sh` and `templates/brainstorm-session.template.md`).

It sits in Agent Workflows, covering Brainstorming. The repository describes itself as: BMAD Method skills for Claude Code - Auto-detection, Memory integration, Slash commands. Transform Claude Code into a BMAD-powered development environment.

When your agent uses it

  • The user says: brainstorm
  • Explore options
  • Six Thinking Hats
  • Creative session

Example prompts

  • “brainstorm”
  • “ideate”
  • “generate ideas”
  • “/bmad-brainstorm”

Requirements

  • A Bash shell
  • Pre-approved tools (allowed-tools): Read, Write, Edit, Bash, Glob, Grep, WebSearch, WebFetch, TodoWrite

Workflow steps

10 steps, taken from the first numbered list in SKILL.md.

  1. Gather context — Ask: topic/problem, relevant constraints, which BMAD track is active
  2. Read project context — Load bmad-output/project-context.md and bmad-output/decision-log.md if present
  3. Select techniques — Choose 2-4 complementary techniques; confirm with user
  4. Execute sessions — Apply each technique systematically (diverge first, do not filter)
  5. Organize ideas — Categorize all generated ideas; label Impact (H/M/L) and Feasibility (H/M/L)
  6. Extract insights — Identify top 3-5 actionable insights across all techniques
  7. Identify risks — Capture risks surfaced during ideation
  8. Produce report — Fill templates/brainstorm-session.template.md; save to output folder
  9. Update decision-log — Record key decisions or directions confirmed during the session
  10. Recommend next steps — Which BMAD skill to engage next

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Bash
    • Glob
    • Grep
    • WebSearch
    • WebFetch
    • TodoWrite

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • bash

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

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    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 Brainstorm loads about 1.8k tokens when it runs. Until then it costs about 196 tokens; SKILL.md has 645 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Write, Edit, Bash, Glob, Grep, WebSearch, WebFetch, TodoWrite

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); the scripts in this folder are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 645 words (~1,839 tokens).

“Structured ideation harness for the BMAD planning lifecycle. Produces a brainstorming-report.md of organized ideas and insights ready to feed downstream planning skills (product-brief, PRD, architecture).”

— opening of SKILL.md by aj-geddes, Custom licence
name
bmad-brainstorm
allowed-tools
Read, Write, Edit, Bash, Glob, Grep, WebSearch, WebFetch, TodoWrite

Read the full SKILL.md on GitHub

Files

SKILL.md and 3 other files (scripts) in bmad-planning-orchestrator/skills/bmad-brainstorm of aj-geddes/claude-code-bmad-skills.

  • SKILL.md
  • scripts/scamper-prompts.sh
  • scripts/swot-template.sh
  • templates/brainstorm-session.template.md

Open the folder on GitHubat commit 27dca0e

Compare with similar skills

Bmad Brainstorm 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 Brainstorm compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bmad Brainstorm this skillaj-geddes/claude-code-bmad-skills488—~1.8kAutomated safety check: NotesCustom licence
Brainstormingobra/superpowers297k1 repos~2.5kAutomated safety check: PassMIT
Brainstormingxpinjection/test-driven-spring-boot11253 repos~2.6kAutomated safety check: PassMIT
Yao Meta Skillyaojingang/yao-meta-skill2.7k—~768Automated safety check: PassMIT
Typesafe AIOpenAgentsInc/openagents4559 repos~2.5kAutomated safety check: PassMIT
Trellis StartROYIANS/foliq-print-template-designer1366 repos~646Automated safety check: PassMIT

Similar skills

  • Brainstorming

    obra/superpowers

    Makes the agent clarify intent and agree on a design with you before writing any code, scaling the process from a quick spike to a written spec.

    297k GitHub starsUsed in 1 repo~2.5k tokens
    Agent WorkflowsAuto-check passed
  • Brainstorming

    xpinjection/test-driven-spring-boot

    You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior.

    112 GitHub starsUsed in 53 repos~2.6k tokens
    Agent WorkflowsAuto-check passed
  • Yao Meta Skill

    yaojingang/yao-meta-skill

    Create, improve, or evaluate an existing skill from workflows, prompts, SOPs, scripts.

    2.7k GitHub stars~768 tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Typesafe AI

    OpenAgentsInc/openagents

    Build AI-powered software with TypeSafe: small units of AI intelligence you can use like programming primitives.

    455 GitHub starsUsed in 9 repos~2.5k tokens
    Agent WorkflowsAuto-check passed
  • Trellis Start

    ROYIANS/foliq-print-template-designer

    Initializes an AI development session by reading workflow guides, developer identity, git status, active tasks, and project guidelines from .trellis/.

    136 GitHub starsUsed in 6 repos~646 tokens
    Agent WorkflowsAuto-check passed
  • Brainstorming Before Building

    jnMetaCode/superpowers-zh

    Turns a rough idea into an approved design before any code is written, sorting the request into spike, bounded or architectural and enforcing an approval gate.

    8.3k GitHub stars~1.8k tokensUpdated 3 days ago
    Agent WorkflowsAuto-check passed

More from aj-geddes/claude-code-bmad-skills

All 20 skills in this repo
  • Bmad Architecture

    aj-geddes/claude-code-bmad-skills

    Solutioning skill (Winston, the Architect). An agent skill from aj-geddes/claude-code-bmad-skills.

    488 GitHub stars~1.9k tokensUpdated 3 mo ago
    Auto-check: notes
  • Bmad Builder

    aj-geddes/claude-code-bmad-skills

    Meta-skill for scaffolding and validating custom PLANNING/ORCHESTRATION skills within the BMAD Planning & Orchestrator plugin.

    488 GitHub stars~1.9k tokensUpdated 3 mo ago
    Auto-check: notes
  • Bmad Epics And Stories

    aj-geddes/claude-code-bmad-skills

    Solutioning flagship — shards a PRD + architecture into epics.md and individual {epic}.{story}.{slug}.story.md context objects, the LAST planning artifact before external dev handoff.

    488 GitHub stars~2.2k tokensUpdated 3 mo ago
    Auto-check: notes
  • Bmad Help

    aj-geddes/claude-code-bmad-skills

    Orchestration spine and "what do I do next?" router for the BMAD Planning & Orchestrator plugin.

    488 GitHub stars~1.7k tokensUpdated 3 mo ago
    Auto-check: notes
  • Bmad Init

    aj-geddes/claude-code-bmad-skills

    Initialize a BMAD planning workspace: pick a scale-adaptive TRACK (Quick Flow / BMad Method / Enterprise) interactively, then scaffold the output folder, a config file, an empty decision-log.md, and…

    488 GitHub stars~1.4k tokensUpdated 3 mo ago
    Auto-check: notes
  • Bmad Parallel Plan

    aj-geddes/claude-code-bmad-skills

    Turns a sequential, ready-for-dev story backlog into conflict-free CONCURRENT WAVES.

    488 GitHub stars~1.8k tokensUpdated 3 mo ago
    Auto-check: notes

Categories

Questions about Bmad Brainstorm

What does Bmad Brainstorm do?

Facilitates structured ideation sessions using proven brainstorming techniques (SCAMPER, SWOT, 5 Whys, Mind Mapping, Six Thinking Hats, Reverse Brainstorming, Starbursting, Brainwriting). Bmad Brainstorm is an agent skill from aj-geddes/claude-code-bmad-skills. Facilitates structured ideation sessions using proven brainstorming techniques (SCAMPER, SWOT, 5 Whys, Mind Mapping, Six Thinking Hats, Reverse Brainstorming, Starbursting, Brainwriting).

When should I use Bmad Brainstorm?

Bmad Brainstorm fits situations like: the user says: brainstorm; explore options; six Thinking Hats; creative session.

How do I install Bmad Brainstorm in Claude Code?

Run `npx skills add aj-geddes/claude-code-bmad-skills --skill bmad-brainstorm -a claude-code`. Or copy the skill folder (bmad-planning-orchestrator/skills/bmad-brainstorm in aj-geddes/claude-code-bmad-skills) into .claude/skills/bmad-brainstorm in your project. Claude Code loads it when a task matches its description.

How do I install Bmad Brainstorm in Codex?

Run `npx skills add aj-geddes/claude-code-bmad-skills --skill bmad-brainstorm -a codex`. Or copy the skill folder (bmad-planning-orchestrator/skills/bmad-brainstorm in aj-geddes/claude-code-bmad-skills) into .agents/skills/bmad-brainstorm in your project. Codex loads it when a task matches its description.

Can I use Bmad Brainstorm 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 aj-geddes/claude-code-bmad-skills --skill bmad-brainstorm -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-brainstorm, .gemini/skills/bmad-brainstorm, .github/skills/bmad-brainstorm and .opencode/skills/bmad-brainstorm in your project.

What does Bmad Brainstorm need to run?

Going by SKILL.md and its folder, Bmad Brainstorm needs a shell for the scripts in its folder and the command-line tools its instructions call (bash). Our summary lists: A Bash shell. Its frontmatter pre-approves these tools: Read, Write, Edit, Bash, Glob, Grep, WebSearch, WebFetch, TodoWrite.

Does Bmad Brainstorm access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Bmad Brainstorm safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Bmad Brainstorm use?

Bmad Brainstorm has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Bmad Brainstorm use?

About 1.8k tokens (SKILL.md is roughly 7.4k 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 Brainstorm?

Skills that share tags, products or a category with Bmad Brainstorm: Brainstorming (obra/superpowers, 297k stars), Brainstorming (xpinjection/test-driven-spring-boot, 112 stars), Yao Meta Skill (yaojingang/yao-meta-skill, 2.7k stars) and Typesafe AI (OpenAgentsInc/openagents, 455 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bmad Brainstorm?

aj-geddes (a GitHub user) maintains it in aj-geddes/claude-code-bmad-skills, which has 488 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on June 20, 2026.

Source: aj-geddes/claude-code-bmad-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.