CtrlK
BlogDocsLog inGet started
Tessl Logo

bmad-brainstorming

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

66

Quality

80%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

High

Do not use without reviewing

Fix and improve this skill with Tessl

tessl review fix ./src/core-skills/bmad-brainstorming/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

85%

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

A well-architected, highly actionable session-management skill with clear sequencing, explicit failure handling, and a clean one-level reference structure. Its only weakness is minor motivational prose in the overview and framing that could be tightened.

Suggestions

Trim flavor lines in the Overview and Framing sections (e.g., 'The best sessions end with the user surprised by what came out') to push conciseness toward a 3.

Consider collapsing the two Framing sub-bullets that restate stance-independent guidance into tighter imperatives.

DimensionReasoningScore

Conciseness

Mostly operational and dense with executable commands, but motivational prose such as "The best sessions end with the user surprised by what came out" and "pushing past the obvious with sharper questions and harder constraints, with no rush to finish" could be trimmed; not a 3 because some flavor lines do not earn their place, and not a 1 because it never explains concepts Claude already knows.

2 / 3

Actionability

Provides copy-paste-ready commands like "uv run {project-root}/_bmad/scripts/memlog.py init --workspace {doc_workspace} --field topic=..." and exact paste-parsing instructions ("the Facilitation mode: line → the stance"), matching the 'fully executable code/commands; copy-paste ready' anchor.

3 / 3

Workflow Clarity

Activation is a numbered 1–5 sequence with explicit failure handling ("On failure or missing values → neutral defaults; never block", "confirm every entry ran before continuing") and the session flow is clearly sequenced through Run a Session → Choosing Techniques → Converging → Wrap-Up, matching the 'clear sequence with explicit validation steps' anchor.

3 / 3

Progressive Disclosure

SKILL.md is an overview pointing to one-level-deep, well-signaled references ("load references/headless.md and follow it", assets/brain-selector.html, scripts/brain.py), all of which exist as real files, matching the 'clear overview with well-signaled one-level-deep references' anchor; no nested 2+ level chains are present.

3 / 3

Total

11

/

12

Passed

Description

75%

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 concise, third-person description with an explicit Use-when trigger and a clear niche. It is strong on completeness and distinctiveness, but the capability list is a single action and the trigger terms cover only two phrasings.

Suggestions

Add one or two more concrete capabilities (e.g., 'structure divergent idea generation, then converge and prioritize') to lift specificity toward a 3.

Broaden trigger terms to include natural variations like 'I need ideas', 'I'm stuck', or 'think of ideas' alongside 'help me brainstorm/ideate'.

DimensionReasoningScore

Specificity

Quotes "Facilitate a brainstorming session using diverse creative techniques" — it names the domain and a core action but lists only one concrete action rather than multiple specific actions, matching the 'names domain and some actions, but not comprehensive' anchor; not a 3 because it lacks a catalog of distinct concrete operations.

2 / 3

Completeness

Explicitly states what ("Facilitate a brainstorming session using diverse creative techniques") and when ("Use when the user says 'help me brainstorm' or 'help me ideate'") with an explicit trigger clause, matching the 'clearly answers both what AND when' anchor; not below 3 because neither half is missing or merely implied.

3 / 3

Trigger Term Quality

Quotes "Use when the user says 'help me brainstorm' or 'help me ideate'" — two natural phrasings are present, but coverage is narrow and misses common variations like 'I need ideas', 'I'm stuck', or 'think of ideas'; not a 3 because the example anchor shows broader variation coverage.

2 / 3

Distinctiveness Conflict Risk

Brainstorming is a clear niche with distinct quoted trigger phrases unlikely to collide with other skills, matching the 'clear niche with distinct triggers' anchor; not a 2 because the triggers are specific rather than a generic 'works with document files'.

3 / 3

Total

10

/

12

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.

Validation15 / 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
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.