brainstorm · gupsammy — Claude Code skill: what it does, how to install
brainstorm — an interview skill that turns the tables: the agent asks, you answer, and the session ends with a written spec or decision doc.
no license ★ 276 updated 2026-10-29
/plugin marketplace add gupsammy/Claudest
/plugin install claude-thinking@ClaudestWhat brainstorm does
Rather than answering your prompts, this skill puts the questions to you. Hand it a topic as an argument and it works through your assumptions, edge cases and unspoken concerns in rounds of two or three questions, driven through AskUserQuestion.
How hard it pushes depends on the subject: strategy gets adversarial probing, personal calls get a gentler line of questioning. Adding --grill switches conduct entirely — one question per turn, each with a recommended answer and a line of reasoning behind it, and the agent reads the code with Read, Grep and Glob before asking anything the files already answer. Bash and Write are on the tool list too.
The interview stops when new themes dry up after four or more rounds, or when your replies keep getting shorter. Under --grill the stopping rule is different, since it runs until every branch of the dependency tree is settled or explicitly deferred. What you keep is a document: a spec, a brief or a record of the decision. If you want an answer rather than your own thoughts sharpened, this will get in the way.
What it helps with
- Map the assumptions hiding behind a rough idea
- Stress-test a rollout plan branch by branch with
--grill - Write down requirements before the first line of code
- Produce a brief or decision record from the conversation
- Expose weak spots in a strategy while it is still words
Example prompts for the agent
- Interview me about the auth redesign and don't let me hand-wave the edge cases.
- Grill my rollout plan with
--grill, one question at a time. - Help me clarify what I actually want from this feature and write it up as a brief.
How to install brainstorm
1Plugin marketplace
/plugin marketplace add gupsammy/Claudest/plugin install claude-thinking@ClaudestThis installs the whole claude-thinking plugin with all its skills
2Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill brainstorm -a claude-code3Manually: put the files in place
~/.claude/skills/brainstorm/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/brainstorm/
1Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill brainstorm -a codex2Manually: put the files in place
.agents/skills/brainstorm/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill brainstorm -a cursor2Manually: put the files in place
.cursor/skills/brainstorm/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install gupsammy/Claudest plugins/claude-thinking/skills/brainstorm2Manually: put the files in place
.github/skills/brainstorm/SKILL.md1Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill brainstorm -a gemini-cli2Platform CLI
gemini skills install https://github.com/gupsammy/Claudest --path plugins/claude-thinking/skills/brainstormManually: put the files in place
.devin/skills/brainstorm/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about brainstorm
How do I install brainstorm in Claude Code?
From the plugin marketplace: run /plugin marketplace add gupsammy/Claudest first, then /plugin install claude-thinking@Claudest.
What does brainstorm do?
It interviews you about a topic, asking questions in small batches and digging into assumptions and edge cases, then writes up the result as a document.
What is the --grill flag for?
It switches to an adversarial mode: one question at a time, each with a recommended answer, and the codebase checked before a question is asked. It ends when every decision branch is resolved or deferred.
Similar skills
All skills for Agent setup: memory, context, orchestration →brainstorm by other authors comes first.