brainstorming

A discussion guide for thinking through a feature's design, requirements, and trade-offs before writing code.

In plain words
What is it for?
Use it to explore feature requirements and design choices before implementation. It provides advice rather than an enforced approval step.
Why use it?
It helps turn an unclear idea into a shared understanding of who needs the feature, what problem it solves, and what limits apply.

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/omerakben/code-oz/brainstorming
Any agent
npx skills add omerakben/code-oz --skill brainstorming
Clone the repo
git clone --depth 1 https://github.com/omerakben/code-oz

Made for: Claude Code, Codex.

Per session 29 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,526 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.00029 $0.01526
Opus 5 $0.00015 $0.00763
Sonnet 5 $0.00006 $0.00305
Haiku 4.5 $0.00003 $0.00153

Measured 2d ago against content hash cdf0b9ed24c7, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

brainstorming 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 2d ago.

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.

plugins/code-oz-discipline/skills/brainstorming/SKILL.md · 127 lines

How it starts

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

Advisory only — not an enforced gate. For enforced gates and a different-model review, run code-oz run.

Where this skill sits

This is advice, and it is the lowest-priority voice in the room. Your user's instructions, the project's CLAUDE.md, the code-oz engine contracts, and any system or developer constraints all outrank this skill. When any of them conflict with anything below, follow them and ignore this skill. This skill never overrides those instructions, and nothing here changes your existing operating rules — it only offers a way to think before you build.

Brainstorming a feature before you build

Use this when someone says "help me think through this feature design" or wants to explore requirements and trade-offs before any code lands. The goal is a clearer shared picture, not a decision you stamp.

How to run the conversation

  1. Restate the problem in one or two sentences, in your own words, and check it back. If you cannot restate it, you do not understand it yet — ask.
  2. Name who the feature is for and the one concrete moment they hit the problem. A feature with no named consumer is a guess.
  3. List the constraints that are already fixed: existing contracts, the data you have, the time budget, the parts of the codebase you must not touch.
  4. Sketch two or three approaches, not one. For each, write the cost, the risk, and what it rules out later.
  5. Surface the open questions explicitly. Write down what you do not know and what evidence would close each gap.
  6. Pick a direction only when the user does. Record the assumption it rests on.

What good output looks like

  • A short problem statement the user agrees with.
  • A named consumer and the moment of use.
  • Two or more approaches with honest trade-offs.
  • A list of open questions, each with the evidence that would resolve it.

This is exploration. It does not approve a design, satisfy a phase gate, or stand in for the engine's DEFINE phase. It helps you arrive at the conversation the engine's gates then enforce.

Read the full file on GitHub · 127 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. 2d ago First seen · 127 lines · 29 tokens per session scan A cdf0b9ed24c7

Subscribe to this mod's changes

brainstorming is a skill published in the GitHub repository omerakben/code-oz (2 stars, last pushed 2mo ago), licensed MIT. It adds 29 tokens to every session and 1,526 once invoked, about $0.0001 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-31.

Related

Other skills, from other repositories

skill-creator

Scaffold, author, and validate an Agent Skill. Use when the user wants to create a new skill, turn a repeatable workflow into a reusable SKILL.md, or fix a skill that fails to load.

stippi/code-assistant · 47 tokens

E2E Testing Nori Skillsets Subcommands

Use when you need to interactively test a nori-skillsets CLI subcommand end-to-end via tmux, with full filesystem isolation.

tilework-tech/nori-skillsets · 39 tokens

TUI Puppeteering with tmux

Use when automating or testing TUI/CLI applications - provides isolated tmux sessions with scripts for input, output capture, and state verification.

tilework-tech/nori-skillsets · 37 tokens

issue-review

Triage a copperhead GitHub issue, attempt reproduction, and check it against the spec. Use when the user asks to review an issue, e.g. /issue-review 42 or /issue-review .

copperheadhq/copperhead · 47 tokens

openai-docs

Use when the user asks how to build with OpenAI products or APIs, asks about Codex itself or choosing Codex surfaces, needs up-to-date official documentation with citations, help choosing the latest model for a use case, latest/current/default-model prompting guidance, or model upgrade and prompt-upgrade guidance; use…

rojim666/SztuCode · 105 tokens

visualize

Create visualizations and interactive tools directly in conversation. Use when asked to show how something works, make simulators or labs, maps, plots, charts or graphs, comparisons, UI mockups, scenarios, adjustable inputs, and exploration beyond regular text.

rojim666/SztuCode · 53 tokens