brainstorm

A planning conversation for turning a rough software idea into a clear design before writing code.

In plain words
What is it for?
Use it to scope features, compare technical approaches, define user needs, and plan a build through focused questions.
Why use it?
It exposes unclear requirements and important choices early, reducing the chance of building the wrong thing.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/autohandai/code-cli/brainstorm
Any agent
npx skills add autohandai/code-cli --skill brainstorm
Clone the repo
git clone --depth 1 https://github.com/autohandai/code-cli

Made for: Claude Code, Codex.

Per session 58 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,075 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00058 $0.01075
Opus 5 $0.00029 $0.00537
Sonnet 5 $0.00012 $0.00215
Haiku 4.5 $0.00006 $0.00108

Measured yesterday against content hash 92b2dcdc7196, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

brainstorm scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

src/skills/builtin/brainstorm/SKILL.md · 95 lines

How it starts

The opening of the file, as written. The whole thing — 95 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Brainstorm before you build

Your job here is not to write code. It is to help the user turn a rough idea into a design a senior engineer would trust. You do this by thinking through the problem with three professional lenses — a Software Architect, a Product Owner, and a Product Manager — and by asking sharp questions instead of guessing.

Hold your solutions loosely. The first framing of a problem is usually wrong, and the cheapest place to fix a design is a conversation, not a diff.

How to run the conversation

  • Ask one question at a time. A wall of questions gets shallow answers. Ask the single most decision-changing question, wait, then ask the next.
  • Prefer concrete choices. When a decision has options, use the host's user-question tool with clearly labeled options and a recommendation. Do not bury a real choice in prose.
  • Do not narrate the whole tree. Pursue the path that matters; skip the branches you have already ruled out.
  • State assumptions and move. When something is safe to assume, say the assumption out loud and proceed rather than asking permission for the obvious.
  • Never jump to code. No file writes, no patches, no scaffolding until the user has approved a design.

The three lenses

Run the idea through each lens. Skip a question only when the answer is already clear — never skip a lens because it feels like overhead.

Software Architect — is it sound?

  • What are the hard constraints (latency, data volume, consistency, platform, existing stack) that the design must respect?
  • What is the data flow? Where does state live, and who owns it?
  • Where are the module seams? What is the smallest set of well-bounded units, each with one clear purpose and a clean interface?
  • What are the failure modes? What happens on timeout, partial write, bad input, or concurrent access?
  • What breaks at 10× the load or scope? Is that acceptable for now (and named as a known limit) or does it need designing out today?
  • Build, buy, or reuse? Does the codebase already solve part of this?

Read the full file on GitHub · 95 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 95 lines · 58 tokens per session scan A 92b2dcdc7196

Subscribe to this mod's changes

brainstorm is a skill published in the GitHub repository autohandai/code-cli (181 stars, last pushed 5d ago), licensed Apache-2.0. It adds 58 tokens to every session and 1,075 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

neuron-test-engineer

Write tests for Neuron AI agents, RAG systems, workflows, and tools using the built-in testing utilities. Use this skill when the user mentions testing agents, writing unit tests, mocking AI providers, testing tool execution, verifying RAG retrieval, testing workflow behavior, or creating test cases for Neuron AI…

neuron-core/neuron-ai · 94 tokens

neuron-evaluation-engineer

Create and run AI evaluations with datasets, assertions, and output drivers in Neuron AI. Use this skill whenever the user mentions evaluation, testing AI systems, creating evaluators, dataset-driven testing, assertion-based validation, or wants to measure AI system performance. Also trigger for tasks involving…

neuron-core/neuron-ai · 77 tokens

neuron-structured-output

Design and implement structured output classes for Neuron AI agents using SchemaProperty attributes and validation rules. Use this skill when the user mentions structured output, JSON schema extraction, data validation, output classes, DTOs for AI responses, extracting structured data from LLM, or configuring property…

neuron-core/neuron-ai · 104 tokens

neuron-agent-builder

Create and configure Neuron AI agents with providers, tools, instructions, and memory. Use this skill whenever the user mentions building agents, creating AI assistants, setting up LLM-powered chat bots, configuring chat agents, or wants to create an agent that can talk, use tools, or handle conversations. Also…

neuron-core/neuron-ai · 89 tokens

neuron-debugger

Debug and monitor Neuron AI applications with Inspector APM, event observability, logging, and performance analysis. Use this skill whenever the user mentions debugging, monitoring, observability, performance analysis, tracing, Inspector, or needs to understand why an agent is behaving a certain way. Also trigger for…

neuron-core/neuron-ai · 90 tokens

neuron-rag-specialist

Implement RAG (Retrieval-Augmented Generation) with Neuron AI including vector stores, embeddings providers, document loaders, and retrieval strategies. Use this skill whenever the user mentions RAG, retrieval, vector search, document retrieval, semantic search, knowledge bases, chat with documents, or wants to build…

neuron-core/neuron-ai · 95 tokens