# brainstorm-experiments

The brainstorm-experiments skill for Claude Code and Codex turns a product hypothesis into a low-cost experiment with a pass threshold set in advance. It selects a method for a new idea or an existing feature.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 104 installs · ★ 1183 repo stars
- Author: borghei
- License: LicenseRef-MIT-Commons-Clause · policy=link-only · description only; the file stays with the author
- Source: https://github.com/borghei/Claude-Skills/tree/HEAD/project-management/discovery/brainstorm-experiments/SKILL.md
- Updated: 2026-11-08
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/brainstorm-experiments

## What it does

The skill frames a test as a measurable claim about what share of a target group will take an action, then suggests a method and a pass bar. For a new product, options include a landing page or pre-order; for an existing one, a fake door or A/B test.

The workflow covers the hypothesis, method, metric, timeboxed run, and result assessment. The `experiment_designer.py` script suggests up to three methods for each hypothesis. Each one needs `hypothesis_text`, `target_segment`, and `product_type` set to `new` or `existing`.

Set the threshold before the test and record a counter-metric in the experiment plan. If a hypothesis has no percentage bar, the script exits with code 1. That makes the pass/fail rule explicit before results come in.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill brainstorm-experiments -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/brainstorm-experiments/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/brainstorm-experiments/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill brainstorm-experiments -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/brainstorm-experiments/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill brainstorm-experiments -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/brainstorm-experiments/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install borghei/Claude-Skills project-management/discovery/brainstorm-experiments
```

2. **Manually: put the files in place**
- File: `.github/skills/brainstorm-experiments/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill brainstorm-experiments -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/borghei/Claude-Skills --path project-management/discovery/brainstorm-experiments
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/brainstorm-experiments/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill brainstorm-experiments -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/borghei/Claude-Skills/tree/HEAD/project-management/discovery/brainstorm-experiments/SKILL.md

## When to use it
- test demand before building a product
- measure willingness to pay
- choose a test for a new idea or an existing feature
- set a pass bar and track a counter-metric

## Example prompts
- Design a test for the claim that at least 10% of the target segment will place a pre-order.
- Suggest an experiment for this new product idea and define its pass threshold.
- Compare ways to test interest in this feature and choose a method.

## Similar
- [brainstorm-experiments-new](https://affpapa.org/en/nevibecode/skills/brainstorm-experiments-new.md) — skill · 3100 installs
- [brainstorm-experiments-existing](https://affpapa.org/en/nevibecode/skills/brainstorm-experiments-existing.md) — skill · 3000 installs
- [creating-experiments](https://affpapa.org/en/nevibecode/skills/creating-experiments.md) — skill · 431 installs
- [auditing-experiments-flags](https://affpapa.org/en/nevibecode/skills/auditing-experiments-flags.md) — skill · 462 installs
- [launch-in-app-experiments](https://affpapa.org/en/nevibecode/commands/launch-in-app-experiments.md) — command · ★ 450 repo stars
- [ar-run](https://affpapa.org/en/nevibecode/skills/ar-run.md) — skill · ★ 30251 repo stars

From the same set: [borghei/claude-skills](https://affpapa.org/en/nevibecode/by/borghei/claude-skills.md) — 120 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
