CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bmad-brainstorming

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

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An unusually strong skill body: executable commands with exact flags, explicit error-recovery loops in the activation sequence, and disciplined conditional loading of one-level-deep reference files. The only deductions are a small duplicated recovery branch and a referenced customize.toml that is missing from the bundle.

Suggestions

Dedupe the 'script not found → offer bmad setup → re-run' recovery instructions in On Activation steps 1 and 3 by stating the recovery once and referencing it.

Ship a default customize.toml in the bundle (or reword the step-1 fallback so it does not point at a file that may not exist), since the fallback 'read {skill-root}/customize.toml directly with defaults' currently has no target.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence — no concept tutorials, no padding, every section instructs. Minor trimmable redundancy keeps it from 5: the 'Script not found: BMad is not set up here. Offer to run the bmad skill's setup...' recovery branch is repeated nearly verbatim in activation steps 1 and 3, and a few long parentheticals could be tightened.

4 / 5

Actionability

Fully executable guidance throughout: exact commands with arguments ('uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow'), complete memlog invocations with every --field/--type/--by flag specified, exact file paths, and even the exact message to say to the user for the composer page. Not below 5 — nothing is pseudocode or left abstract.

5 / 5

Workflow Clarity

Clear sequenced phases (On Activation 1-5, Run a Session, Choosing Techniques, Converging, Wrap-Up) with explicit validation and error-recovery loops: script-not-found branches that offer setup and re-run, 'if either hook list was non-empty, confirm every entry ran before continuing', and 'You can't see their browser, so never claim it opened'. This matches the anchor 'clear sequence with explicit validation steps; feedback loops for error recovery'.

5 / 5

Progressive Disclosure

The body is a genuine overview with well-signaled, one-level-deep references loaded conditionally per mode (references/mode-*.md, converge.md, finalize.md, headless.md, resume.md), and all of those files plus scripts/brain.py and assets/brain-selector.html exist in the bundle. One minor gap keeps it from 5: {skill-root}/customize.toml is cited as the fallback to read when resolve_customization.py fails, but that file is absent from the bundle, so the stated fallback path is dangling.

4 / 5

Total

18

/

20

Passed

Description

82%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A well-formed description with an explicit what, a verbatim natural trigger clause, and a distinct niche. Its only weakness is thin capability specificity — one action plus the generic phrase 'diverse creative techniques' rather than a concrete list of what the session does.

Suggestions

Replace the generic 'using diverse creative techniques' with 2-3 concrete capabilities, e.g. 'Facilitate a brainstorming session — pick creative techniques, generate and log 100+ ideas, then converge on the best ones'.

Broaden trigger coverage with natural variations users say, such as 'come up with ideas', 'generate ideas', or 'ideation session', alongside the existing quoted phrases.

Consider mentioning the supported modes (facilitate, partner, or ideate for me) to sharpen the what-clause and further distinguish the skill from generic ideation helpers.

DimensionReasoningScore

Specificity

"Facilitate a brainstorming session using diverse creative techniques" names the domain and one concrete action, but "diverse creative techniques" is generic and there is no list of several specific capabilities. It matches the anchor 'names domain and 1-2 concrete actions, but not comprehensive' — not 4, which requires several specific actions, and not 2, since the action is more than minimal like 'Processes PDF files'.

3 / 5

Completeness

Both parts are explicit: the what ("Facilitate a brainstorming session using diverse creative techniques") and the when with concrete quoted trigger phrases ("Use when the user says 'help me brainstorm' or 'help me ideate'"). Not 4, because that anchor applies when the 'when' could be more explicit — here the triggers are already verbatim and maximally specific.

5 / 5

Trigger Term Quality

The explicit triggers "'help me brainstorm'" and "'help me ideate'" are verbatim natural phrases a user would say, giving good keyword coverage. Not 5 because common variations like "come up with ideas", "generate ideas", or "ideation session" are missing.

4 / 5

Distinctiveness Conflict Risk

Brainstorming facilitation is a clear niche, and the quoted trigger phrases ('help me brainstorm', 'help me ideate') are distinct and unlikely to fire for unrelated skills. Minimal conflict risk.

5 / 5

Total

17

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

bmad-code-org/BMAD-METHOD

Path

skills/bmad-brainstorming/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.