Agent skill

Octocode Brainstorming

by bgauryy in bgauryy/octocode

Walks an idea through framing, diverging into options, researching evidence and stress-testing before converging on a build, prototype, narrow or park decision.

MITAuto-check passedAgent Workflows

Install Octocode Brainstorming

skills CLI
$ npx skills add bgauryy/octocode --skill octocode-brainstorming -a claude-code

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

GitHub CLI
$ gh skill install bgauryy/octocode octocode-brainstorming --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/bgauryy/octocode.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/octocode-brainstorming .claude/skills/octocode-brainstorming && 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
octocode-brainstorming
GitHub stars
949
Token cost
~1.3k tokens
SKILL.md length
548 words
Files
19 (incl. scripts, references)
Skills in repo
12
Repo updated
First seen
Licence
MIT

At a glance

Walks an idea through framing, diverging into options, researching evidence and stress-testing before converging on a build, prototype, narrow or park decision.

  • Deciding whether an idea is worth building before writing any code
  • SKILL.md covers Modes and lobby rules, Hard gate, Smart routes — load only what… and Related routes, plus 2 more sections
  • Runs JavaScript scripts from its folder; calls node; needs SERPER_API_KEY and TAVILY_API_KEY
  • Mapping adjacent solutions and prior art for a new feature idea

What it does

The flow runs frame, diverge, research, cross-pollinate, stress-test, synthesize and decide. Generate mode produces 6 to 10 angles and validates the best 2 to 3; validate mode produces 2 to 4 reframings and investigates them deeply; map mode expands adjacent terms and surveys existing solutions. Before judging anything, the skill asks the user to pick a direction, audience or research surface whenever that choice is unclear.

A Surface Plan marks which sources, such as local files, top web results or repository and package evidence, are active or skipped with a reason, and every claim is tracked from source through confidence to the next query rather than treated as settled. Stress-testing runs three lenses, a critical architect, a visionary entrepreneur and a product view, plus cross-examination, before any verdict is reached.

A hard gate stops the process and asks the user to choose when the idea spans three unrelated spaces, evidence stays thin after retrying synonyms, evidence conflicts, or delegating further would need more than five workers. Reference files are loaded only for the current step, keeping the context load proportional to what the step actually needs.

When your agent uses it

  • Deciding whether an idea is worth building before writing any code
  • Mapping adjacent solutions and prior art for a new feature idea
  • Choosing between building an RFC, a prototype, narrowing scope or parking an idea

Example prompts

  • “Brainstorm whether we should build our own vector search or use a managed one.”
  • “Help me explore angles on a browser extension for saving research notes.”
  • “Stress-test the idea of adding real-time collaboration before we scope it.”

What it can do on your machine

Read from SKILL.md and the folder at commit c265e3f. 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

    Ships 2 files in scripts/ (JavaScript, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • node

    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 these keys or tokens, usually read from environment variables:

    • SERPER_API_KEY
    • TAVILY_API_KEY
    • EXA_API_KEY

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

Context cost

Octocode Brainstorming loads about 1.3k tokens when it runs, and up to ~7.4k if it reads all its reference files. Until then it costs about 84 tokens; SKILL.md has 548 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from bgauryy/octocode at commit c265e3f, republished under its MIT licence (© bgauryy). 548 words, ~1,305 tokens.

Download SKILL.mdSave it as .claude/skills/octocode-brainstorming/SKILL.md (or your agent's skills folder). This skill also uses 18 other files; get the full folder from GitHub.
name
octocode-brainstorming
description
Use when an idea needs disciplined exploration before building: generate options, test whether it is worth building, map adjacent solutions, challenge assumptions, narrow scope, or choose Build RFC / Prototype / Narrow / Park — even if nobody said brainstorm. Already decided to implement a specific plan → skip.

Octocode Brainstorming

Evidence-grounded idea exploration. Flow: FRAME → DIVERGE → RESEARCH → CROSS-POLLINATE → STRESS-TEST → SYNTHESIZE → DECIDE.

Modes and lobby rules

  • Generate: create 6–10 angles, then validate the best 2–3. Validate: produce 2–4 reframings, then investigate deeply. Map: expand adjacent terms and landscape existing solutions.
  • Capture framing before judging. When direction, audience, or research surface is unclear, ask the user to choose before deep research.
  • Declare a Surface Plan: mark local, top resources/web, and repository/package/code evidence active or skipped with a reason.
  • Treat snippets and summaries as leads; cite exact sources or mark claims weak. Track claim → source → confidence → next query.
  • Cross-pollinate across each active surface and run Critical Architect, Visionary Entrepreneur, and Product lenses before verdict.
  • Recall potentially useful context first and validate it; capture only durable lessons that survive rebuttal.

Hard gate

Stop, recommend one option, and wait when the idea spans three unrelated spaces, active evidence stays thin after synonym retries, evidence materially conflicts, or delegation would exceed five workers.

Smart routes — load only what the current step needs

  • When framing the idea and diverging into angles, build the Surface Plan with references/tools.md; when code/repository/package evidence is active, load references/octocode.md — choose sources deliberately and delegate technical research correctly.
  • When generic results cannot prove momentum, crowdedness, publication, or shipped prior art, load references/trend-sources.md — add time-sensitive evidence without domain lock-in.
  • When cross-pollinating leads from one active surface into another, stay in references/tools.md and references/web-search-workers.md — carry each finding across surfaces instead of closing a surface early.
  • When stress-testing, load references/debate.md — run the three lenses and cross-examination before converging.
  • When research is substantial, multi-turn, or delegated, load references/hook-communication.md and run scripts/brainstorm-run.mjs — preserve a resumable claim/source/decision ledger.
  • When synthesizing and deciding, load references/output.md and score every prior-art claim with references/confidence.md; if the user approves a durable artifact, load references/brief-template.md — match chat brevity or saved decision depth.
  • When methods or source contracts are challenged, load references/grounding.md — make the process falsifiable.
  • When improving this skill, prefer octocode-graph-eval; otherwise load references/improve-loop.md — require measurable acceptance.
Show full SKILL.md (223 more words)Show less
  • Use octocode-rfc-generator for a Build verdict; octocode-research for technical evidence; octocode-graph-eval for measurable experiments.
  • Use octocode-skills when changing this skill folder.
  • Use octocode-subagent to dispatch and synthesize workers — see references/web-search-workers.md for the brainstorm-specific Scout/Aggregator/Checker topology and the five-worker ceiling.

Scripts — every one takes --help

ScriptRun whenHow
scripts/brainstorm-run.mjsresearch is substantial, multi-turn, delegated, or saved as a briefnode <skill_dir>/scripts/brainstorm-run.mjs start --idea "<idea>" --mode Validate, then checkpoint --run-id <id>, then finish --run-id <id>; hook --event <event> serves hooks/hooks.json; commands in references/hook-communication.md
scripts/serper-search.mjsvalidating web credentials at session startnode <skill_dir>/scripts/serper-search.mjs --check — broad Google results (SERPER_API_KEY)
scripts/tavily-search.mjsvalidating web credentials at session startnode <skill_dir>/scripts/tavily-search.mjs --check — curated/deeper research (TAVILY_API_KEY)
scripts/exa-search.mjsvalidating web credentials at session startnode <skill_dir>/scripts/exa-search.mjs --check — neural/category search (EXA_API_KEY)
  • Use the --check scripts for credential presence only; fetching and search output come from the host web tool. Default to querying every validated engine and consolidating, not a first-success ladder (references/tools.md).
  • All four scripts import the vendored scripts/octocode-config.mjs for Octocode home and env; never import @octocodeai/config, which is absent when this folder installs alone.

Output

Use TL;DR, Framings, Evidence by surface, What survived review, Verdict, Risks, Next, Sources. Always end with Sources — a consolidated list of every URL/path actually cited above with the claim it backs, even for chat-only answers never saved as a brief. Template: references/output.md and references/brief-template.md.

© bgauryy, 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 18 other files (scripts, references) in skills/octocode-brainstorming of bgauryy/octocode.

  • SKILL.md
  • README.md
  • agents/openai.yaml
  • hooks/hooks.json
  • references/brief-template.md
  • references/confidence.md
  • references/debate.md
  • references/grounding.md
  • references/hook-communication.md
  • references/improve-loop.md
  • references/octocode.md
  • references/output.md
  • references/tools.md
  • references/trend-sources.md
  • references/web-search-workers.md
  • scripts/brainstorm-run.mjs
  • scripts/exa-search.mjs
  • … and 2 more

Open the folder on GitHubat commit c265e3f

Compare with similar skills

Octocode Brainstorming 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.

Octocode Brainstorming compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Octocode Brainstorming this skillbgauryy/octocode949—~1.3kAutomated safety check: PassMIT
Issue Intelligence Analystudecode/plate17k—~3.9kAutomated safety check: PassCustom licence
Next Idea Ideation Loopbreaking-brake/cc-wf-studio5.4k—~1kAutomated safety check: PassCustom licence
Work Issuejoesaby/astro-mermaid123—~891Automated safety check: PassMIT
News to Research Idea BriefingOpenLAIR/dr-claw1.2k—~1.3kAutomated safety check: NotesCustom licence
Diagnosing Superpowers Sessionsobra/superpowers297k3 repos~1.7kAutomated safety check: PassMIT

Similar skills

  • Fetches and analyzes GitHub issues to surface recurring themes, pain patterns, and severity trends.

    17k GitHub stars~3.9k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Next Idea Ideation Loop

    breaking-brake/cc-wf-studio

    Runs one unattended ideation round for cc-wf-studio: orient on plans and issues, invent user-visible improvements, judge them against a value bar and file the winners as locked idea issues.

    5.4k GitHub stars~1k tokensUpdated 4 days ago
    Agent WorkflowsAuto-check passed
  • Work Issue

    joesaby/astro-mermaid

    End-to-end workflow for resolving a GitHub issue in astro-mermaid — triages complexity, then runs brainstorm → TDD → implement → docs/spec → code review at the right depth.

    123 GitHub stars~891 tokensUpdated 2 mo ago
    DevelopmentAuto-check passed
  • Clusters the latest news-feed results by topic and writes a briefing of research idea seeds with citations, plus a structured seeds file, without crawling new sources.

    1.2k GitHub stars~1.3k tokensUpdated 23 days ago
    Research & ScienceAuto-check: notes
  • Investigates a session where Superpowers went wrong, reads the transcripts on disk and produces an evidence-cited report, optionally prepared as a bug report for the maintainers.

    297k GitHub starsUsed in 3 repos~1.7k tokens
    Agent WorkflowsAuto-check passed
  • 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

More from bgauryy/octocode

All 12 skills in this repo
  • Runs blind pairwise comparisons of Octocode against a gh-based baseline over markdown research questions, scored by total characters through the model rather than self-report.

    949 GitHub stars~2.1k tokensUpdated 2 days ago
    Auto-check passed
  • Octocode Code Research

    bgauryy/octocode

    Researches code with evidence: traces callers, imports and cross-repo links, diagnoses failures and reports findings with exact file and line references and a confidence label.

    949 GitHub stars~1.5k tokensUpdated 2 days ago
    Auto-check passed
  • Writes, repairs and copyedits project docs against the Google developer documentation style guide, verifying claims in the repository before stating them.

    949 GitHub stars~2k tokensUpdated 2 days ago
    Auto-check passed
  • Octocode Mannequin

    bgauryy/octocode

    Poses and animates a 22-bone anatomical humanoid rig with joint range-of-motion limits, using a Node CLI, a Three.js viewer and WebMCP tools an agent can drive live.

    949 GitHub stars~1.2k tokensUpdated 2 days ago
    Auto-check passed
  • Octocode Skills Manager

    bgauryy/octocode

    Finds, rates, reviews, creates, improves, installs and syncs Agent Skill folders from local workspaces, registries or remote sources, with a user gate before any write.

    949 GitHub stars~1.2k tokensUpdated 2 days ago
    Auto-check passed
  • Octocode Chrome Devtools

    bgauryy/octocode

    A skill your agent uses when a live page needs Chrome DevTools/CDP evidence: network failures, console errors, performance, DOM/CSS actionability, screenshots/PDF, cookies/storage…

    949 GitHub stars~1.6k tokensUpdated 2 days ago
    Auto-check passed

Works with

Categories

Questions about Octocode Brainstorming

What does Octocode Brainstorming do?

Walks an idea through framing, diverging into options, researching evidence and stress-testing before converging on a build, prototype, narrow or park decision. The flow runs frame, diverge, research, cross-pollinate, stress-test, synthesize and decide. Generate mode produces 6 to 10 angles and validates the best 2 to 3; validate mode produces 2 to 4 reframings and investigates them deeply; map mode expands adjacent terms and surveys existing solutions.

When should I use Octocode Brainstorming?

Octocode Brainstorming fits situations like: deciding whether an idea is worth building before writing any code; mapping adjacent solutions and prior art for a new feature idea; choosing between building an RFC, a prototype, narrowing scope or parking an idea.

How do I install Octocode Brainstorming in Claude Code?

Run `npx skills add bgauryy/octocode --skill octocode-brainstorming -a claude-code`. Or copy the skill folder (skills/octocode-brainstorming in bgauryy/octocode) into .claude/skills/octocode-brainstorming in your project. Claude Code loads it when a task matches its description.

How do I install Octocode Brainstorming in Codex?

Run `npx skills add bgauryy/octocode --skill octocode-brainstorming -a codex`. Or copy the skill folder (skills/octocode-brainstorming in bgauryy/octocode) into .agents/skills/octocode-brainstorming in your project. Codex loads it when a task matches its description.

Can I use Octocode Brainstorming 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 bgauryy/octocode --skill octocode-brainstorming -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/octocode-brainstorming, .gemini/skills/octocode-brainstorming, .github/skills/octocode-brainstorming and .opencode/skills/octocode-brainstorming in your project.

What does Octocode Brainstorming need to run?

Going by SKILL.md and its folder, Octocode Brainstorming needs JavaScript for the scripts in its folder, the command-line tools its instructions call (node) and credentials named SERPER_API_KEY, TAVILY_API_KEY and EXA_API_KEY.

Does Octocode Brainstorming 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 Octocode Brainstorming 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Octocode Brainstorming use?

Octocode Brainstorming 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 Octocode Brainstorming use?

About 1.3k tokens (SKILL.md is roughly 5.2k 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 6.1k tokens, read only when the agent opens those files.

What are the alternatives to Octocode Brainstorming?

Skills that share tags, products or a category with Octocode Brainstorming: Issue Intelligence Analyst (udecode/plate, 17k stars), Next Idea Ideation Loop (breaking-brake/cc-wf-studio, 5.4k stars), Work Issue (joesaby/astro-mermaid, 123 stars) and News to Research Idea Briefing (OpenLAIR/dr-claw, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Octocode Brainstorming?

bgauryy (a GitHub user) maintains it in bgauryy/octocode, which has 949 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 9, 2026.

Source: bgauryy/octocode on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.