brainstorming · davidkiss — Claude Code skill: what it does, how to install
brainstorming transforms loose concepts into structured technical specs through dialogue. Halts premature code changes until every requirement is confirmed.
no license 164 installs ★ 4 updated 2026-05-08
npx skills add davidkiss/smart-ai-skills --skill brainstorming -a claude-codeWhat brainstorming does
The skill stops the agent from touching code when starting a complex task. It forces the assistant to examine repository history and documentation first with the @investigator skill. Then it starts a focused interview. Only one question arrives per message. To speed up decisions, the model proposes two or three approaches with trade-offs, discarding unneeded details under YAGNI principles.
Once requirements are clear, the assistant outlines the spec in sections of 200–300 words. You review each section before the next one appears. The discussion covers architecture and error handling. The final document lands in docs/YYYY-MM-DD-<topic>-specs.md. Until the user explicitly approves the plan, the agent cannot edit any project files.
What it helps with
- turn loose feature ideas into structured technical specs
- prevent AI assistants from editing code prematurely
- compare two or three design approaches with clear trade-offs
- document project requirements in versioned Markdown files
Example prompts for the agent
- Let's brainstorm the architecture for our payment gateway integration
- Help me design the specs for user session management
- Brainstorm a background worker system before writing any code
How to install brainstorming
1Skills CLI (Vercel)
npx skills add davidkiss/smart-ai-skills --skill brainstorming -a claude-code2Manually: put the files in place
~/.claude/skills/brainstorming/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/brainstorming/
1Skills CLI (Vercel)
npx skills add davidkiss/smart-ai-skills --skill brainstorming -a codex2Manually: put the files in place
.agents/skills/brainstorming/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add davidkiss/smart-ai-skills --skill brainstorming -a cursor2Manually: put the files in place
.cursor/skills/brainstorming/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install davidkiss/smart-ai-skills skills/brainstorming2Manually: put the files in place
.github/skills/brainstorming/SKILL.md1Skills CLI (Vercel)
npx skills add davidkiss/smart-ai-skills --skill brainstorming -a gemini-cli2Platform CLI
gemini skills install https://github.com/davidkiss/smart-ai-skills --path skills/brainstormingManually: put the files in place
.devin/skills/brainstorming/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add davidkiss/smart-ai-skills --skill brainstorming -a opencodeClaude.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 brainstorming
How to install brainstorming in Claude Code?
Run npx skills add davidkiss/smart-ai-skills --skill brainstorming -a claude-code. The file will be placed in ~/.claude/skills/brainstorming/SKILL.md.
What does the brainstorming skill do?
It guides the assistant through a structured question-and-answer design phase before touching any code. The agent checks project context, offers concrete alternatives, and validates specifications incrementally.
Where are the finalized specifications stored?
Once validated, the assistant writes the specification directly to docs/YYYY-MM-DD-<topic>-specs.md.
Similar skills
All skills for Agent setup: memory, context, orchestration →brainstorming by other authors comes first.