brainstorm skill
✓ VerifiedExecutes a diverge-to-converge workflow to ideate, challenge, and evaluate ideas, technical approaches, or strategic decisions.
- GitHub stars
- 1,663
- Files
- 1
- Last commit
- Nov 9, 2026
- License
- Apache-2.0
- Allowed tools
- —
What does the brainstorm skill do?
brainstorm executes a diverge-to-converge workflow to ideate, challenge, and evaluate ideas, technical approaches, or strategic decisions.
Summary generated from the skill's SKILL.md.
About the brainstorm skill
Developing strategic decisions or technical approaches through a structured diverge-to-converge workflow is what this skill enables. It is designed for developers and strategists who need to move from broad ideation to a narrow set of actionable choices. An agent should load this tool when a user needs to expand options, pressure-test ideas, or compare complex concepts. The process begins by establishing a baseline solution and then generating distinct options across practical and unusual angles.
To ensure quality, the tool actively challenges weak assumptions and failure modes. It specifically rejects speculative generality by requiring that every new abstraction or data copy has a current caller. Users can choose between a Quick format for rapid clustering and three final picks, or a Deep format for high-stakes decisions that require an evaluation table and detailed recommendations. The workflow concludes by selecting the strongest three options based on relevant criteria and the cost of deletion, favoring smaller options in the event of a tie.
What an agent can do with it
- 1Evaluating technical implementationsAsk the agent to compare different technical approaches and identify potential risks or tradeoffs.
- 2Generating creative naming optionsRequest a list of potential names categorized by tone, fit, and ease of pronunciation.
- 3Developing content strategiesUse the tool to plan content angles, hooks, and outlines for a specific audience.
- 4Pressure-testing product ideasChallenge a new product concept by identifying failure modes and verifying load-bearing claims.
Written from the skill's SKILL.md. Every use case is checked against a quote from it.
How to install the brainstorm skill
Each command copies the skill folder into the client's skills directory. Restart the client or start a new session to load it.Install the brainstorm skill in Claude Code
~/.claude/skills/brainstorm/SKILL.md
$ npx degit codeaholicguy/ai-devkit/skills/brainstorm ~/.claude/skills/brainstormInstall the brainstorm skill in Claude Code (project)
.claude/skills/brainstorm/SKILL.md
$ npx degit codeaholicguy/ai-devkit/skills/brainstorm .claude/skills/brainstormInstall the brainstorm skill in Codex
~/.agents/skills/brainstorm/SKILL.md
$ npx degit codeaholicguy/ai-devkit/skills/brainstorm ~/.agents/skills/brainstormInstall the brainstorm skill in Gemini CLI
~/.gemini/skills/brainstorm/SKILL.md
$ npx degit codeaholicguy/ai-devkit/skills/brainstorm ~/.gemini/skills/brainstormInstall the brainstorm skill in Claude.ai
npx degit codeaholicguy/ai-devkit/skills/brainstorm brainstorm && zip -r brainstorm.zip brainstorm # claude.ai → Customize → Skills → + → Create skill → Upload a skill → brainstorm.zip
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the scripts before you let an agent run them. How checks work
- Source repository linked and reachablecodeaholicguy/ai-devkit/skills/brainstorm is public and reachablegithub.com/codeaholicguy/ai-devkit/tree/HEAD/skills/brainsto ↗Pass
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit 2026-11-09github.com/codeaholicguy/ai-devkit/commits ↗Pass
- No download-and-run or credential theft in scriptsNo scripts in the skill folderPass
- No hidden instructions in SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/codeaholicguy/ai-devkit/blob/HEAD/skills/brainsto ↗Pass
- Pre-approved tools are scopedNo pre-approved tools; the agent asks before using onegithub.com/codeaholicguy/ai-devkit/blob/HEAD/skills/brainsto ↗Pass
- SKILL.md follows the Agent Skills formatValid name and description; says when to use it; 30 linesgithub.com/codeaholicguy/ai-devkit/blob/HEAD/skills/brainsto ↗Pass
SKILL.md
View on GitHubBrainstorm
Run a compact diverge-to-converge loop.
Workflow
- Frame: goal, constraints, audience, success criteria, assumptions.
- Baseline: state the simplest honest solution first. Every option must beat it; the baseline stays a candidate.
- Diverge: distinct options across practical, high-leverage, and unusual angles.
- Challenge: weak assumptions, failure modes, tradeoffs, rejections. Always: reject speculative generality (each abstraction, layer, flag, and data copy needs a current caller) and verify load-bearing "needed" claims in the consuming code, not doc assertions.
- Compare: only relevant criteria, plus deletion cost (how easily the option can be removed later). Ties go to the smaller option.
- Converge: strongest 3 picks with rationale and a next step. Self-review first: for each new constant, object, layer, and flag ask "why do we need this?" Cut answers that are only messaging or future-proofing.
Formats
Use Quick by default. Use Deep only for ambiguous or high-stakes decisions. Ask at most one clarifying question only if missing context would materially change the brainstorm; otherwise state assumptions and proceed.
- Quick: clusters, challenges, 3 picks.
- Deep: assumptions, clusters, evaluation table, recommendation.
- Naming: tone groups, fit, ambiguity, pronunciation.
- Technical: approaches, tradeoffs, risks, validation.
- Content: angles, hooks, audiences, outlines.
Avoid filler, near-duplicates, generic best practices, premature recommendations, and scope without a current caller. If asked for more ideas, explore a new axis before listing variants.
Files in this skill
1brainstorm skill questions
How do I install the brainstorm skill in Claude Code?
Run npx degit codeaholicguy/ai-devkit/skills/brainstorm ~/.claude/skills/brainstorm. Claude Code loads skills from ~/.claude/skills (all projects) or .claude/skills (one project) and uses a skill when its description matches the task.
Which clients can use the brainstorm skill?
Any client that reads the Agent Skills format: Claude Code, Codex, Gemini CLI and claude.ai (upload as a ZIP). Scripts in the skill run only where the client allows code execution.
How does the skill handle ambiguity or missing context?
It asks at most one clarifying question if missing context would materially change the outcome; otherwise, it states assumptions and proceeds.