Agent skill

OMA Brainstorm

by first-fluke in first-fluke/oh-my-agent

Explores goals, constraints and alternative designs one question at a time and saves an approved design document before any planning or coding starts.

MITAuto-check passedAgent Workflows

Install OMA Brainstorm

skills CLI
$ npx skills add first-fluke/oh-my-agent --skill oma-brainstorm -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install first-fluke/oh-my-agent oma-brainstorm --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/first-fluke/oh-my-agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/oma-brainstorm .claude/skills/oma-brainstorm && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
oma-brainstorm
GitHub stars
1.3k
Token cost
~2.8k tokens
SKILL.md length
1,275 words
Files
24 (incl. references)
Skills in repo
57
Repo updated
First seen
Licence
MIT

At a glance

Explores goals, constraints and alternative designs one question at a time and saves an approved design document before any planning or coding starts.

  • Works in 3 steps: Confirm that the request is exploratory… → Load enough project context to… → Start with intent and constraints, not…
  • You have an idea but the requirements are still vague
  • SKILL.md covers Scheduling, Structural Flow, Logical Operations and References
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Design-first ideation for ambiguous requests. The skill asks one question at a time to understand intent and constraints, then lays out viable approaches as prose briefs covering the scenario, the mechanism and the remaining risk, with a comparison and recommendation when that helps you choose. An optional TRIZ-lite step, kept in resources/triz-lite.md, helps when a contradiction stops distinct approaches from emerging.

The design is approved section by section and goes through a blind review round before it is saved; Tier 1 issues must be resolved and Tier 2 and 3 issues resolved or explicitly deferred. For high-stakes designs it may dispatch fresh-context reviewer subagents. The skill stops before implementation or task planning and hands the saved design to the PM workflow. Clear requirements go to oma-pm instead, code review to oma-qa and debugging to oma-debug.

When your agent uses it

  • You have an idea but the requirements are still vague
  • Comparing design approaches and their trade-offs
  • Producing an approved design before running /plan

Example prompts

  • “I have an idea for a team-wide feature flag system, so let's design it.”
  • “Brainstorm three ways to add offline support to our notes app.”
  • “Compare approaches for rate limiting before we plan anything.”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Confirm that the request is exploratory rather than ready for implementation.
  2. Load enough project context to understand constraints.
  3. Start with intent and constraints, not solutions.

What it can do on your machine

Read from SKILL.md and the folder at commit 268bb4a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

OMA Brainstorm loads about 2.8k tokens when it runs, and up to ~17k if it reads all its reference files. Until then it costs about 39 tokens; SKILL.md has 1,275 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~39
When it runs · the whole SKILL.md, loaded when a task matches
~2.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~17k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from first-fluke/oh-my-agent at commit 268bb4a, republished under its MIT licence (© first-fluke). 1,275 words, ~2,818 tokens.

Download SKILL.mdSave it as .claude/skills/oma-brainstorm/SKILL.md (or your agent's skills folder). This skill also uses 23 other files; get the full folder from GitHub.
name
oma-brainstorm
description
Explore goals, constraints, and alternative approaches before choosing a design. Use when the user requests ideation or design exploration.

Brainstorm - Design-First Ideation

Scheduling

Goal

Explore user intent, constraints, and alternative approaches before planning or implementation, then preserve an approved design for downstream planning.

Intent signature
  • User says they have an idea, want to brainstorm, compare approaches, explore concepts, or design before planning.
  • Request is ambiguous enough that implementation or task planning would be premature.
When to use
  • Exploring a new feature idea before planning
  • Understanding user intent and constraints before committing to an approach
  • Comparing multiple design approaches with trade-offs
  • When the user says "I have an idea" or "let's design something"
  • Before invoking /plan for complex or ambiguous requests
When NOT to use
  • Requirements are already clear and well-defined -> use oma-pm directly
  • Implementing actual code -> delegate to specialized agents
  • Performing code reviews -> use oma-qa
  • Debugging existing issues -> use oma-debug
Expected inputs
  • Early idea, ambiguous goal, product concept, design question, or set of constraints
  • Existing project context when the idea must fit a codebase or product direction
  • User preferences and approval gates
Expected outputs
  • Clarified intent and constraints
  • Viable approaches as prose briefs (scenario, mechanism, residual risk), with comparison and recommendation when alternatives aid the decision
  • Section-by-section approved design document
  • Blind-review issue list (Tier 1 resolved, Tier 2/3 resolved or explicitly deferred)
  • Saved design artifact before handoff to planning
Dependencies
  • Shared context loading, reasoning templates, clarification protocol, quality principles, and skill routing
  • Optional resources/triz-lite.md for contradiction-shaped approach seeding
  • Per-agent reviewer dispatch (e.g. qa-reviewer, architecture-reviewer) for the high-stakes blind-review escalation path
  • Downstream PM workflow for task decomposition after design approval
Control-flow features
  • Branches by ambiguity, user answers, approach comparison, and approval gates
  • Optional TRIZ-lite branch when a technical/UX contradiction blocks distinct approaches
  • Asks one question at a time
  • Blind review round before save; may dispatch fresh-context reviewer subagents for high-stakes designs (the only subagent-spawning path in this skill)
  • Stops before implementation or task planning

Structural Flow

Entry
  1. Confirm that the request is exploratory rather than ready for implementation.
  2. Load enough project context to understand constraints.
  3. Start with intent and constraints, not solutions.
Scenes
  1. PREPARE: Explore context and frame the design question.
  2. ACQUIRE: Ask clarifying questions one at a time.
  3. REASON: Compare viable approaches with tradeoffs when alternatives aid the decision; explain binding constraints when only one remains.
  4. VERIFY: Reuse existing design authority and resolve only material open choices, then run a blind review round (independent lenses critique without seeing each other's feedback) before saving.
  5. FINALIZE: Save design and transition to planning when appropriate.
Transitions
  • If requirements become clear and implementation-ready, transition to PM planning.
  • If user rejects an approach, revise before moving to detailed design.
  • If implementation pressure appears early, defer it until design approval.
  • If approaches collapse into knob-turning on one axis, load resources/triz-lite.md and reseed, then re-present prose briefs.
Failure and recovery
  • If the user cannot answer a question, propose assumptions and ask for confirmation.
  • If scope expands, split the design into smaller sections.
  • If alternatives collapse into one option, identify the real constraint causing that; use TRIZ-lite only when that constraint is a technical/UX contradiction.
Exit
  • Success: approved design exists and is ready for planning.
  • Partial success: open questions and assumptions are explicit.

Logical Operations

Actions
ActionSSL primitiveEvidence
Read context and ideaREADUser prompt and project context
Ask targeted questionsREQUESTClarification phase
Compare approachesCOMPARETradeoff matrix
Infer recommendationINFERRecommended option
Record option selectionCALL_TOOLActual approach, comparison evidence, and design/option revision; matching instanceId and verifier --instance in an active OMA workflow
Resolve design authorityVALIDATEExisting instruction, delegated choice, or explicit answer for an unresolved material design choice
Run blind reviewVALIDATEIndependent lens critiques, tiered issue list, Tier 1 resolution
Write design artifactWRITEdocs/plans/designs/ and memory
Transition to planNOTIFYHandoff summary
Tools and instruments
  • Context loading, reasoning templates, clarification protocol
  • Optional TRIZ-lite resource for contradiction seeding
  • Project memory and docs/plans/designs/ for persisted designs
Canonical workflow path
text
1. Ask one clarifying question at a time.
2. (Optional) If technical/UX contradiction or same-axis approaches only → resources/triz-lite.md.
3. Present viable alternatives as prose briefs and compare them when useful; do not invent extra options to meet a count; reuse an existing selection or delegated choice and resolve only an open material choice. In an active OMA workflow, record the actual approach, rationale, evidence, and design/option revision with `brainstorm.option-selection`; verify the matching --instance (workflow Step 3 owns the commands).
4. Design section by section within existing authorization, then blind review: independent lenses suited to the uncertainty and stakes critique the design; resolve Tier 1 issues (fresh-context reviewer subagents for high-stakes designs).
5. Save the approved design to `docs/plans/designs/` before handing off to planning.
Resource scope
ScopeResource target
MEMORYUser intent, assumptions, decisions
CODEBASEExisting project context when relevant
LOCAL_FSApproved design artifacts; optional TRIZ-lite appendix in design doc
Preconditions
  • The user is still exploring or the request is ambiguous.
  • The agent can ask clarifying questions before implementation.
Effects and side effects
  • Produces design decisions and persisted design docs.
  • Influences downstream planning but does not implement code.
Show full SKILL.md (565 more words)Show less
Guardrails
  1. No implementation or planning before design approval - brainstorm produces a design document, not code or task plans
  2. One question at a time - ask clarification and approval questions through the available asynchronous question tool first, following references/_shared/core/clarification-protocol.md; fall back to a permitted question tool or plain text. Continue independent work while waiting, and never infer approval from silence or a preselected option.
  3. Compare viable approaches - offer two or three when they aid the decision, and explain constraints when fewer remain. Recommend according to the actual goal, effort, reversibility, and risk. Do not favor a larger structural change solely because of its label.
  4. Explain viable approaches in prose - state scenario, mechanism, residual risk, and effort. Use a comparison matrix when it helps the decision, then give the recommendation; a single constrained option needs its rationale, not invented alternatives
  5. Section-by-section design - present the design incrementally; reuse existing decisions and delegated authority, asking only for unresolved material choices under the shared execution policy
  6. Blind review before save - mandatory unless the design is trivially small (1-2 files, low stakes); lenses critique independently; use fresh-context reviewer subagents for architecturally significant, hard-to-reverse, or security-/compliance-sensitive designs
  7. YAGNI - do not over-engineer; design only what is needed for the stated goal
  8. TRIZ-lite is optional - only for technical/UX contradictions or same-axis collapse; max 3–5 principles from the curated set; no fake scores, full TRIZ/ARIZ, or classical matrices; seeds feed Step 3 briefs and do not replace user approval
  9. Save design, then transition - persist the approved design document before handing off to /plan
Execution Phases

Follow the brainstorm workflow step by step:

  1. Phase 1 - Context: Explore the existing codebase and understand the project landscape
  2. Phase 2 - Questions: Ask clarifying questions one at a time to understand intent and constraints
  3. Phase 3 - Approaches: Optionally seed with TRIZ-lite for a real contradiction; compare viable approaches in prose and recommend according to the stated constraints, effort, reversibility, and risk
  4. Phase 4 - Design: Present the detailed design section by section, preserving existing authorization and resolving only open material choices
  5. Phase 5 - Blind Review: Use independent reviewer lenses proportionate to the design uncertainty and stakes, consolidate into Tier 1/2/3 issues, resolve Tier 1 before save; escalate to fresh-context reviewer subagents for high-stakes designs. Skip only for trivially small designs (1-2 files, low stakes)
  6. Phase 6 - Documentation: Save the approved design to docs/plans/designs/ and project memory
  7. Phase 7 - Transition: Hand off to /plan for task decomposition
Common Pitfalls
  • Jumping to solutions: Asking "how" before fully understanding "what" and "why"
  • Too many questions at once: Overwhelming the user with a wall of questions
  • Single approach bias: Skipping viable alternatives without explaining binding constraints
  • Matrix-only options: Dumping a trade-off table without scenario/mechanism prose so the user cannot choose
  • Same-axis "alternatives": Three intensities of the same knob (interval/TTL/debounce) presented as distinct approaches
  • TRIZ on everything: Loading triz-lite without a real contradiction, adding ceremony without better options
  • Over-engineering: Designing for hypothetical future requirements instead of stated needs
  • Inventing design authority: Treating an agent recommendation as approval of a user-owned unresolved choice, or asking again for a choice already authorized
  • Skipping blind review: Saving a non-trivial design without the independent critique round, or letting the design's author-context leak into escalated reviewer prompts

References

  • TRIZ-lite (optional Step 3 seeding): resources/triz-lite.md
  • Context loading: references/_shared/core/context-loading.md
  • Clarification protocol: references/_shared/core/clarification-protocol.md
  • Quality principles: references/_shared/core/quality-principles.md
  • Skill-to-agent mapping: references/_shared/core/skill-routing.md

© first-fluke, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 23 other files (references) in skills/oma-brainstorm of first-fluke/oh-my-agent.

  • SKILL.md
  • references/_shared/conditional/experiment-ledger.md
  • references/_shared/conditional/exploration-loop.md
  • references/_shared/conditional/quality-score.md
  • references/_shared/core/api-contracts/README.md
  • references/_shared/core/api-contracts/template.md
  • references/_shared/core/clarification-protocol.md
  • references/_shared/core/common-checklist.md
  • references/_shared/core/context-budget.md
  • references/_shared/core/context-loading.md
  • references/_shared/core/difficulty-guide.md
  • references/_shared/core/execution-policy.md
  • references/_shared/core/lessons-learned.md
  • references/_shared/core/prompt-structure.md
  • references/_shared/core/quality-principles.md
  • references/_shared/core/session-metrics.md
  • … and 8 more

Open the folder on GitHubat commit 268bb4a

Used in 1 other repository

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders. This page covers the copy in first-fluke/oh-my-agent, which our catalogue first saw on October 7, 2026.

Compare with similar skills

OMA Brainstorm next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

OMA Brainstorm compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
OMA Brainstorm this skillfirst-fluke/oh-my-agent1.3k—~2.8kAutomated safety check: PassMIT
Brainstormingobra/superpowers297k1 repos~2.5kAutomated safety check: PassMIT
Brainstorming Before BuildingjnMetaCode/superpowers-zh8.3k—~1.8kAutomated safety check: PassMIT
CE BrainstormEveryInc/compound-engineering-plugin25k—~1.9kAutomated safety check: PassMIT
Grill Menateherkai/AIS-OS1.6k—~1.8kAutomated safety check: PassCustom licence
Architect Before You Buildjsmastery-pro/jsm-agent-skill221—~1.1kAutomated safety check: PassMIT

Similar skills

  • Brainstorming

    obra/superpowers

    Makes the agent clarify intent and agree on a design with you before writing any code, scaling the process from a quick spike to a written spec.

    297k GitHub starsUsed in 1 repo~2.5k tokens
    Agent WorkflowsAuto-check passed
  • Brainstorming Before Building

    jnMetaCode/superpowers-zh

    Turns a rough idea into an approved design before any code is written, sorting the request into spike, bounded or architectural and enforcing an approval gate.

    8.3k GitHub stars~1.8k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed
  • CE Brainstorm

    EveryInc/compound-engineering-plugin

    Turns a vague or ambitious feature idea into a requirements-only plan through dialogue with you, sized to the work, before any code is written.

    25k GitHub stars~1.9k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed
  • Grill Me

    nateherkai/AIS-OS

    Interview the user relentlessly about a plan, design, or topic, checkpointing every answer to a brainstorm file so nothing is lost.

    1.6k GitHub stars~1.8k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Architect Before You Build

    jsmastery-pro/jsm-agent-skill

    Runs a short design conversation before coding: aligns on terms, works through the decisions that matter and ends with a plan you confirm.

    221 GitHub stars~1.1k tokensUpdated 3 mo ago
    Agent WorkflowsAuto-check passed
  • Feature Brainstorm

    VeryGoodOpenSource/vgv-wingspan

    Clarifies what to build before how, by asking one question at a time about a feature idea and then handing the result on to planning.

    109 GitHub stars~1.8k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed

More from first-fluke/oh-my-agent

All 57 skills in this repo
  • OMA Multi-Agent Orchestration

    first-fluke/oh-my-agent

    Decomposes a complex feature into tasks, dispatches parallel specialist agents with durable state, and supervises verification, QA review and retries.

    1.3k GitHub stars~4.1k tokensUpdated today
    Auto-check passed
  • OMA Multi-Agent Orchestrator

    first-fluke/oh-my-agent

    Splits a complex feature into prioritized tasks, spawns specialist CLI subagents in parallel, tracks them through shared memory and verifies each result.

    1.3k GitHub stars~3.1k tokensUpdated today
    Auto-check passed
  • Architecture Decisions and ADRs

    first-fluke/oh-my-agent

    Evaluates system boundaries and tradeoffs and writes architecture recommendations, option comparisons or ADRs, with a Mermaid diagram when structure changes.

    1.3k GitHub stars~2.6k tokensUpdated today
    Auto-check passed
  • Oma Coordination

    first-fluke/oh-my-agent

    Coordinate assigned specialist tasks and handoffs manually. An agent skill from first-fluke/oh-my-agent.

    1.3k GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Oma Image

    first-fluke/oh-my-agent

    Generate raster images or reference-guided variations through the OMA image CLI.

    1.3k GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Oma PDF

    first-fluke/oh-my-agent

    Extract PDF text, headings, tables, and images into Markdown using opendataloader-pdf.

    1.3k GitHub stars~2.2k tokensUpdated today
    Auto-check passed

Categories

Questions about OMA Brainstorm

What does OMA Brainstorm do?

Explores goals, constraints and alternative designs one question at a time and saves an approved design document before any planning or coding starts. Design-first ideation for ambiguous requests. The skill asks one question at a time to understand intent and constraints, then lays out viable approaches as prose briefs covering the scenario, the mechanism and the remaining risk, with a comparison and recommendation when that helps you choose.

When should I use OMA Brainstorm?

OMA Brainstorm fits situations like: you have an idea but the requirements are still vague; comparing design approaches and their trade-offs; producing an approved design before running /plan.

How do I install OMA Brainstorm in Claude Code?

Run `npx skills add first-fluke/oh-my-agent --skill oma-brainstorm -a claude-code`. Or copy the skill folder (skills/oma-brainstorm in first-fluke/oh-my-agent) into .claude/skills/oma-brainstorm in your project. Claude Code loads it when a task matches its description.

How do I install OMA Brainstorm in Codex?

Run `npx skills add first-fluke/oh-my-agent --skill oma-brainstorm -a codex`. Or copy the skill folder (skills/oma-brainstorm in first-fluke/oh-my-agent) into .agents/skills/oma-brainstorm in your project. Codex loads it when a task matches its description.

Can I use OMA Brainstorm in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add first-fluke/oh-my-agent --skill oma-brainstorm -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/oma-brainstorm, .gemini/skills/oma-brainstorm, .github/skills/oma-brainstorm and .opencode/skills/oma-brainstorm in your project.

What does OMA Brainstorm need to run?

SKILL.md names no scripts, command-line tools or credentials: OMA Brainstorm is instructions for the agent only.

Does OMA Brainstorm access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is OMA Brainstorm safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does OMA Brainstorm use?

OMA Brainstorm is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does OMA Brainstorm use?

About 2.8k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 15k tokens, read only when the agent opens those files.

What are the alternatives to OMA Brainstorm?

Skills that share tags, products or a category with OMA Brainstorm: Brainstorming (obra/superpowers, 297k stars), Brainstorming Before Building (jnMetaCode/superpowers-zh, 8.3k stars), CE Brainstorm (EveryInc/compound-engineering-plugin, 25k stars) and Grill Me (nateherkai/AIS-OS, 1.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains OMA Brainstorm?

first-fluke (a GitHub organization) maintains it in first-fluke/oh-my-agent, which has 1,336 GitHub stars. The repository holds 57 skills in this directory. The repository was last updated on October 10, 2026.

Source: first-fluke/oh-my-agent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.