Agent skill

Brainstorm Experiments

by borghei in borghei/Claude-Skills

Experiment design expert using pretotyping and lean validation for both new product concepts and existing product features.

MITAuto-check passedAgent Workflows

Install Brainstorm Experiments

skills CLI
$ npx skills add borghei/Claude-Skills --skill brainstorm-experiments -a claude-code

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

GitHub CLI
$ gh skill install borghei/Claude-Skills brainstorm-experiments --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/borghei/Claude-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/project-management/discovery/brainstorm-experiments .claude/skills/brainstorm-experiments && 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
brainstorm-experiments
GitHub stars
881
Token cost
~1.7k tokens
SKILL.md length
746 words
Files
7 (incl. scripts, references, assets)
Skills in repo
349
Repo updated
First seen
Licence
MIT

At a glance

Experiment design expert using pretotyping and lean validation for both new product concepts and existing product features.

  • Tasks that involve Brainstorming
  • SKILL.md covers Overview, Core Capabilities, When to Use and Clarify First, plus 5 more sections
  • Runs Python scripts from its folder; calls python3
  • Tasks that involve Experimental design

What it does

Brainstorm Experiments is an agent skill from borghei/Claude-Skills. Experiment design expert using pretotyping and lean validation for both new product concepts and existing product features.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files, including scripts, reference files and assets (for example `assets/experiment_plan_template.md`, `examples/ai-summarization-willingness-to-pay-experiment.md` and `references/experiment-methods.md`).

It sits in Agent Workflows, covering Brainstorming and Experimental design. The repository describes itself as: 385 AI skills, 77 expert agents, and 900 stdlib Python tools for every team: engineering, PM, marketing, C-level, compliance, business ops, research, and a LinkedIn toolkit… The licence is MIT.

When your agent uses it

  • Tasks that involve Brainstorming
  • Tasks that involve Experimental design

Example prompts

  • “/brainstorm-experiments”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 4a698e8. 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 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    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

Brainstorm Experiments loads about 1.7k tokens when it runs, and up to ~9.1k if it reads all its reference files. Until then it costs about 37 tokens; SKILL.md has 746 words of instructions outside code blocks.

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

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 borghei/Claude-Skills at commit 4a698e8, republished under its MIT licence (© borghei). 746 words, ~1,683 tokens.

Download SKILL.mdSave it as .claude/skills/brainstorm-experiments/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
brainstorm-experiments
description
Experiment design expert using pretotyping and lean validation for both new product concepts and existing product features.
license
MIT + Commons Clause
metadata.version
1.0.1
metadata.author
borghei
metadata.category
project-management
metadata.domain
product-discovery
metadata.updated
2026-06-15
metadata.python-tools
experiment_designer.py
metadata.tech-stack
pretotyping, lean-validation, ab-testing, xyz-hypothesis

Experiment Design Expert

Overview

Design fast, low-cost experiments to validate product hypotheses before committing to full development. This skill applies Alberto Savoia's pretotyping philosophy ("Make sure you are building The Right It before you build It right") alongside lean experimentation methods for both new and existing products.

Core Capabilities

  • XYZ hypotheses — frame every test as "At least X% of Y will do Z" with a pre-set pass/fail threshold.
  • SITG + YODA discipline — prefer skin-in-the-game signals (money, time, reputation) and Your Own Data over surveys and benchmarks.
  • Method selection — landing page, explainer video, pre-order, concierge MVP (new products); fake door, feature stub, A/B test, Wizard of Oz, in-app survey (existing).
  • 5-step process — hypothesis, method, metric/threshold, timeboxed run, evaluate (pass/fail/inconclusive).
  • Automated design — experiment_designer.py suggests 2-3 experiments per hypothesis with metric, threshold, effort, and duration.

When to Use

  • You have a product idea or feature hypothesis and need to validate it cheaply.
  • You want to test willingness to pay or genuine user interest, not just stated preference.
  • You need to choose the right experiment method for your context (new vs. existing product).

Clarify First

Before designing the experiment, confirm these inputs. If any is unknown or vague, ASK — do not assume:

  • Hypothesis to test — the specific belief stated as "At least X% of Y will do Z" (drives hypothesis_text and the pass/fail threshold)
  • Product type — new vs existing (selects the method catalog: landing page / pre-order / concierge vs fake door / feature stub / A-B test)
  • Target segment — who "Y" is in the hypothesis (drives the metric and who you expose the test to)
  • Available SITG signal — what skin-in-the-game you can capture (money, time, reputation) given budget/tooling (narrows realistic methods)

Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.

Quick Start

bash
python3 scripts/experiment_designer.py --demo            # built-in sample (3 hypotheses)
python3 scripts/experiment_designer.py input.json        # design experiments for your hypotheses
python3 scripts/experiment_designer.py input.json --format json

Each hypothesis needs hypothesis_text, target_segment, and product_type (new/existing). Document each experiment with assets/experiment_plan_template.md.

Prototype-First Experiments

AI app builders, AI design tools, and AI coding assistants can produce a clickable or working prototype in hours. Treat it as one more experiment method, with the same XYZ hypothesis and pre-set threshold:

  • Use it when the riskiest assumption is usability or desirability of a specific interaction. For demand ("will anyone want this at all?"), a landing page, fake door, or pre-order is still cheaper and more honest.
  • Test it with 5-8 target users on scripted tasks; measure task success and errors, not compliments. Say plainly that it is a prototype.
  • Guard the data — use synthetic data; do not load customer PII into third-party tools without approval.
  • Record the outcome in assets/experiment_plan_template.md, then carry validated results into execution/create-prd/ (Prototype-First Path) — the PRD still owns problem, metrics, constraints, non-goals, and risks.
Show full SKILL.md (296 more words)Show less

References

Load the reference that matches the task — keep this file lean and pull detail on demand:

  • references/methodology-and-tools.md — the XYZ/SITG/YODA principles, the experiment-type catalog for new and existing products, the 5-step process, experiment_designer.py usage and flags, output template, troubleshooting, success criteria, and bibliography. Read when designing or scripting an experiment.
  • references/experiment-methods.md — Savoia's pretotyping manifesto and pretotype types, the full lean-experiment catalog (discovery and validation), metric selection guide, threshold-setting framework, sample-size rules of thumb, and 8 common pitfalls. Read for the deep method reference.
  • references/red-flags.md — anti-patterns (confirmation-biased design, no pre-set threshold, vanity metrics, peeking) with bad/good experiment specs. Read before running an experiment.

Scope & Limitations

In Scope: XYZ hypothesis formulation and validation; experiment method selection for new products (landing page, pre-order, concierge, explainer video) and existing products (fake door, feature stub, A/B test, Wizard of Oz, in-app survey); automated experiment design from hypothesis keyword analysis; metric selection, success threshold definition, and effort/duration estimation.

Out of Scope: statistical power analysis or sample size calculation (use dedicated A/B test platforms); experiment infrastructure setup (feature flags, analytics instrumentation); running the actual experiment (this skill designs, not executes); long-term product strategy or roadmap decisions (execution/outcome-roadmap/).

Important Caveats: pretotyping validates demand and value, not usability or performance; in-app surveys are the weakest SITG signal — use only when behavioral experiments are impractical; the tool's keyword-to-signal matching is heuristic — override when domain knowledge dictates a better method.

Integration Points

IntegrationDirectionDescription
brainstorm-ideas/Receives fromIdeas generated become hypotheses for experiment design
identify-assumptions/Receives from"Test Now" assumptions become hypotheses for this skill
pre-mortem/Feeds intoExperiment results inform pre-mortem risk assessment before full build
execution/create-prd/Feeds intoValidated hypotheses become PRD assumptions with evidence
execution/brainstorm-okrs/Feeds intoExperiment metrics may become OKR key results
execution/outcome-roadmap/Feeds intoExperiment outcomes inform Now/Next/Later roadmap placement

© borghei, 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 6 other files (scripts, references, assets) in project-management/discovery/brainstorm-experiments of borghei/Claude-Skills.

  • SKILL.md
  • assets/experiment_plan_template.md
  • examples/ai-summarization-willingness-to-pay-experiment.md
  • references/experiment-methods.md
  • references/methodology-and-tools.md
  • references/red-flags.md
  • scripts/experiment_designer.py

Open the folder on GitHubat commit 4a698e8

Compare with similar skills

Brainstorm Experiments 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.

Brainstorm Experiments compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Brainstorm Experiments this skillborghei/Claude-Skills881—~1.7kAutomated safety check: PassMIT
Scientific BrainstormingOleafly/Oleafly2062 repos~3.5kAutomated safety check: PassMIT
Academic GrillExekiel179/psyclaw103—~2kAutomated safety check: PassMIT
Idea Discovery PipelineGRIND-Lab-Core/night_owl_research_agent106—~4.4kAutomated safety check: WarnNone
Academic Researchvoidful/academic-skills133—~887Automated safety check: PassMIT
Medical Research Gap To Study Planneraipoch/medical-research-skills2k—~3.6kAutomated safety check: PassMIT

Similar skills

  • Facilitates evidence-aware scientific ideation with independent generation, structured discussion, explicit assumptions, transparent evaluation, adversarial review, and decision logs.

    206 GitHub starsUsed in 2 repos~3.5k tokens
    Research & ScienceAuto-check passed
  • Academic Grill

    Exekiel179/psyclaw

    Stress-test an academic research question, proposal, study design, analysis plan, manuscript claim, review protocol, or AI research project through a one-question-at-a-time interview until its…

    103 GitHub stars~2k tokensUpdated 9 days ago
    Research & ScienceAuto-check passed
  • Idea Discovery Pipeline

    GRIND-Lab-Core/night_owl_research_agent

    The full pipeline for idea generation. An agent skill from GRIND-Lab-Core/night_owl_research_agent.

    106 GitHub stars~4.4k tokensUpdated 5 mo ago
    Research & ScienceAuto-check: warnings
  • Academic Research

    voidful/academic-skills

    Complete academic research skill suite covering the full pipeline: paper reading (read/explain papers with storytelling), idea generation (brainstorm research directions), experiment design (plan…

    133 GitHub stars~887 tokensUpdated 6 mo ago
    Research & ScienceAuto-check passed
  • Medical Research Gap To Study Planner

    aipoch/medical-research-skills

    Converts an audited medical research gap into a complete, structured, gap-traceable study design.

    2k GitHub stars~3.6k tokensUpdated 20 days ago
    Research & ScienceAuto-check passed
  • Business Brainstorm

    coreyhaines31/makerskills

    When you want to pressure-test a potential new business, product, or side project against the serial-founder filter.

    848 GitHub stars~1.7k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed

More from borghei/Claude-Skills

All 349 skills in this repo
  • Agents In The Team

    borghei/Claude-Skills

    Run delivery when AI coding and ops agents take tickets. An agent skill from borghei/Claude-Skills.

    881 GitHub stars~4.2k tokensUpdated today
    Auto-check passed
  • AI Content Disclosure

    borghei/Claude-Skills

    Check AI-generated marketing content and reviews for required disclosures under the EU AI Act, FTC rules and platform AI-label policies.

    881 GitHub stars~3.4k tokensUpdated today
    Auto-check passed
  • AI Prototyping

    borghei/Claude-Skills

    Idea to AI-generated prototype to customer validation to engineering handoff.

    881 GitHub stars~3.6k tokensUpdated today
    Auto-check passed
  • Analytics Engineer

    borghei/Claude-Skills

    Analytics engineering across data modeling, dbt, transformation, and semantic layers.

    881 GitHub stars~3.4k tokensUpdated today
    Auto-check passed
  • Ansoff Matrix

    borghei/Claude-Skills

    Ansoff Matrix — 4-quadrant framework for growth options: market penetration, market/product development, and diversification.

    881 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Brainstorm Okrs

    borghei/Claude-Skills

    OKR brainstorming and validation using the Radical Focus framework — outcome objectives, measurable key results, counter-metrics.

    881 GitHub stars~1.4k tokensUpdated today
    Auto-check passed

Questions about Brainstorm Experiments

What does Brainstorm Experiments do?

Experiment design expert using pretotyping and lean validation for both new product concepts and existing product features. Brainstorm Experiments is an agent skill from borghei/Claude-Skills. Experiment design expert using pretotyping and lean validation for both new product concepts and existing product features.

When should I use Brainstorm Experiments?

Brainstorm Experiments fits situations like: tasks that involve Brainstorming; tasks that involve Experimental design.

How do I install Brainstorm Experiments in Claude Code?

Run `npx skills add borghei/Claude-Skills --skill brainstorm-experiments -a claude-code`. Or copy the skill folder (project-management/discovery/brainstorm-experiments in borghei/Claude-Skills) into .claude/skills/brainstorm-experiments in your project. Claude Code loads it when a task matches its description.

How do I install Brainstorm Experiments in Codex?

Run `npx skills add borghei/Claude-Skills --skill brainstorm-experiments -a codex`. Or copy the skill folder (project-management/discovery/brainstorm-experiments in borghei/Claude-Skills) into .agents/skills/brainstorm-experiments in your project. Codex loads it when a task matches its description.

Can I use Brainstorm Experiments 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 borghei/Claude-Skills --skill brainstorm-experiments -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/brainstorm-experiments, .gemini/skills/brainstorm-experiments, .github/skills/brainstorm-experiments and .opencode/skills/brainstorm-experiments in your project.

What does Brainstorm Experiments need to run?

Going by SKILL.md and its folder, Brainstorm Experiments needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Brainstorm Experiments 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 Brainstorm Experiments 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 Brainstorm Experiments use?

Brainstorm Experiments is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Brainstorm Experiments use?

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

What are the alternatives to Brainstorm Experiments?

Skills that share tags, products or a category with Brainstorm Experiments: Scientific Brainstorming (Oleafly/Oleafly, 206 stars), Academic Grill (Exekiel179/psyclaw, 103 stars), Idea Discovery Pipeline (GRIND-Lab-Core/night_owl_research_agent, 106 stars) and Academic Research (voidful/academic-skills, 133 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Brainstorm Experiments?

borghei (a GitHub user) maintains it in borghei/Claude-Skills, which has 881 GitHub stars. The repository holds 349 skills in this directory. The repository was last updated on October 7, 2026.

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