Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
borghei avatar

Brainstorm Experiments

  • 95 installs
  • 451 repo stars
  • Updated July 21, 2026
  • borghei/claude-skills

brainstorm-experiments is a Claude skill that designs low-cost pretotyping and lean-validation experiments to test product hypotheses before full development.

About

brainstorm-experiments is a Claude skill for designing fast, low-cost experiments to validate product hypotheses before building. It applies Alberto Savoia's pretotyping and lean validation, framing hypotheses in the XYZ format and favoring skin-in-the-game signals over surveys. A developer uses it to choose the right experiment method for a new or existing product and define pass/fail metrics, with a Python experiment_designer.py CLI.

  • Designs low-cost experiments to validate product hypotheses using pretotyping and lean methods
  • XYZ falsifiable hypotheses, skin-in-the-game signals, and your-own-data principle
  • Experiment catalogs for new products (landing page, pre-order, concierge MVP) and existing products (fake door, A/B, Wiz

Brainstorm Experiments by the numbers

  • 95 all-time installs (skills.sh)
  • Ranked #1,383 of 3,282 Productivity & Planning skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
At a glance

brainstorm-experiments capabilities & compatibility

Free; local experiment_designer.py CLI, no API keys.

Capabilities
ab test setup · experiment designer · landing page validation
Use cases
planning · research · project management
Pricing
Free
From the docs

What brainstorm-experiments says it does

Design fast, low-cost experiments to validate product hypotheses before committing to full development.
SKILL.md
Make sure you are building The Right It before you build It right
SKILL.md
Stated interest is unreliable. Valid experiments measure actions that require commitment
SKILL.md
npx skills add https://github.com/borghei/claude-skills --skill brainstorm-experiments

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs95
repo stars451
Last updatedJuly 21, 2026
Repositoryborghei/claude-skills

What it does

Design low-cost pretotyping and lean experiments with falsifiable XYZ hypotheses to validate a product idea or feature.

Who is it for?

Developers and product managers who need to cheaply validate demand or willingness to pay before building.

Skip if: Running the statistical analysis of a live A/B test's results (that is ab-test-setup's job).

When should I use this skill?

When you have a product idea or feature hypothesis and need to validate it cheaply, or want to test willingness to pay.

What you get

A chosen experiment method with a falsifiable XYZ hypothesis and pass/fail threshold set before running.

  • falsifiable XYZ hypothesis
  • chosen experiment method
  • pass/fail metric and threshold

By the numbers

  • 4 experiment methods for new products and 5 for existing products
  • 3 core principles (XYZ hypothesis, Skin-in-the-Game, Your Own Data)

Files

SKILL.mdMarkdownGitHub ↗

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.

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).

Core Principles

1. XYZ Hypothesis Format

Every experiment starts with a falsifiable hypothesis:

"At least X% of Y will do Z."

ComponentDescriptionExample
X%The success threshold15%
YThe target populationtrial users who reach the dashboard
ZThe specific measurable actionclick "Upgrade to Pro" within 7 days

A good XYZ hypothesis is specific, measurable, and has a clear pass/fail threshold set before the experiment runs.

2. Skin-in-the-Game (SITG)

Stated interest is unreliable. Valid experiments measure actions that require commitment:

  • Money -- Pre-orders, deposits, paid waitlists.
  • Time -- Signing up, completing a multi-step flow, scheduling a demo.
  • Reputation -- Sharing with colleagues, posting publicly.

Always prefer SITG signals over surveys, likes, or verbal feedback.

3. Your Own Data (YODA)

Do not rely on market reports, competitor benchmarks, or industry averages. Run your own experiment with your own audience to get Your Own Data. Others' data reflects their context, not yours.

Experiment Types

For New Products

MethodDescriptionBest ForEffortDuration
Landing PageSingle-page site describing the product with a CTA (sign up, pre-order)Testing value proposition and demandLow1-2 weeks
Explainer VideoShort video demonstrating the concept with a CTATesting comprehension and interestLow-Medium1-2 weeks
Pre-Order / WaitlistAccept payment or email for a product that does not exist yetTesting willingness to payLow2-4 weeks
Concierge MVPDeliver the service manually to a small group, as if automatedTesting whether the solution actually solves the problemMedium2-4 weeks

For Existing Products

MethodDescriptionBest ForEffortDuration
Fake Door TestAdd a button/link for a feature that does not exist; measure clicksTesting demand for a specific featureLow1-2 weeks
Feature StubBuild minimal version (e.g., static mockup) behind a flagTesting engagement with a feature conceptLow-Medium1-2 weeks
A/B TestShow variant to a percentage of users; measure conversionTesting incremental changes to existing flowsMedium2-4 weeks
Wizard of OzFeature appears automated to user but is manually operated behind the scenesTesting complex features before building automationMedium-High2-4 weeks
Survey (In-App)Targeted survey shown to users who match specific behavioral criteriaTesting preferences when SITG methods are impracticalLow1 week

Methodology

Step 1: Write the XYZ Hypothesis

Start with the assumption you need to test. Convert it into XYZ format.

Weak: "Users will like the new dashboard." Strong: "At least 30% of active users who see the new dashboard will set it as their default view within 5 days."

Step 2: Select the Experiment Method

Choose based on:

  • Product type (new vs. existing)
  • What you are testing (demand, usability, willingness to pay, engagement)
  • Available effort (team capacity and timeline)
  • Required confidence (directional signal vs. statistically significant result)

Step 3: Define the Metric and Threshold

ElementDescription
Primary metricThe single number that determines pass/fail
Success thresholdThe minimum value to consider the hypothesis validated
Secondary metricsAdditional signals to watch (but not used for pass/fail)
Guardrail metricsMetrics that must NOT degrade (e.g., existing conversion rate)

Step 4: Run the Experiment

  • Set a timebox. Every experiment has a fixed end date.
  • Do not peek. Avoid checking results daily and making early calls.
  • Document everything. Record setup, audience, duration, and any anomalies.

Step 5: Evaluate Results

OutcomeMeaningNext Action
Clear passMetric exceeds thresholdProceed to build or next validation stage
Clear failMetric well below thresholdPivot, modify hypothesis, or abandon
InconclusiveMetric near threshold or insufficient sampleExtend duration, increase sample, or refine experiment

Python Tool: experiment_designer.py

Design experiments from hypotheses using the CLI tool:

# Run with demo data
python3 scripts/experiment_designer.py --demo

# Run with custom input
python3 scripts/experiment_designer.py input.json

# Output as JSON
python3 scripts/experiment_designer.py input.json --format json

Input Format

{
  "hypotheses": [
    {
      "hypothesis_text": "At least 20% of trial users will click Upgrade within 7 days",
      "target_segment": "trial users on free plan",
      "product_type": "existing"
    }
  ]
}

Output

For each hypothesis, the tool suggests 2-3 experiment designs with method, metric, success threshold, effort level, and duration estimate.

See scripts/experiment_designer.py for full documentation.

Output Template

Use assets/experiment_plan_template.md to document each experiment:

  • Experiment card with hypothesis, method, metric, threshold, owner, timeline
  • Experiment tracker for managing multiple concurrent experiments
  • Results documentation for recording outcomes and decisions

Integration with Other Discovery Skills

  • Use brainstorm-ideas/ to generate ideas that become hypotheses.
  • Use identify-assumptions/ to find the riskiest assumptions to test.
  • After experiments, use pre-mortem/ before committing to full build.

Troubleshooting

SymptomLikely CauseResolution
Tool suggests only low-SITG experimentsHypothesis text lacks action-oriented keywords (pay, purchase, upgrade)Rewrite hypothesis using explicit behavioral verbs; check KEYWORD_SIGNALS mapping in script
All experiments recommended are the same methodHypothesis signals are too narrow or product_type is wrongVerify product_type is set correctly (new vs. existing); broaden hypothesis to cover more intent signals
Demo mode works but custom input failsInput JSON schema does not match expected format (missing hypotheses key)Validate JSON has top-level hypotheses array with hypothesis_text, target_segment, product_type per entry
Experiment results are always inconclusiveSample size too small or experiment duration too short for the metricExtend timebox, increase traffic allocation, or choose a metric with higher signal-to-noise ratio
Fake door test shows high clicks but feature never buildsNo decision framework tied to experiment outcomeDefine clear pass/fail thresholds before running; document the "if pass, then build" commitment upfront
Team runs experiments but never acts on resultsResults not connected to roadmap or prioritization processFeed experiment outcomes into identify-assumptions/ for re-scoring; link to execution/outcome-roadmap/

Success Criteria

  • Every product hypothesis has a falsifiable XYZ statement before experiment design begins
  • Experiments measure Skin-in-the-Game (SITG) signals, not stated preferences
  • Pass/fail thresholds are defined before the experiment runs, not after
  • Experiment duration does not exceed 4 weeks for any single hypothesis
  • At least 70% of experiments produce a clear pass or fail verdict (not inconclusive)
  • Results directly feed the build/pivot/abandon decision within 1 week of experiment completion
  • Your Own Data (YODA) principle is followed -- no reliance on industry benchmarks for go/no-go decisions

Scope & Limitations

In Scope:

  • XYZ hypothesis formulation and validation for product ideas
  • Experiment method selection for both 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 suggestions based on 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 experiments, not executes them)
  • Long-term product strategy or roadmap decisions (see execution/outcome-roadmap/)

Important Caveats:

  • Pretotyping is for validating demand and value, not for measuring usability or performance.
  • In-app surveys are the weakest SITG signal. Use them only when behavioral experiments are impractical.
  • The tool's keyword-to-signal matching is heuristic-based. Review suggested experiments and 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

Tool Reference

experiment_designer.py

Suggests 2-3 experiment designs for each product hypothesis based on keyword signal analysis.

FlagTypeDefaultDescription
input_filepositional(optional)Path to JSON file with hypotheses array
--demoflagoffRun with built-in sample data (3 hypotheses)
--formatchoicetextOutput format: text or json

References

  • Alberto Savoia, The Right It (2019)
  • Eric Ries, The Lean Startup (2011)
  • Jeff Gothelf & Josh Seiden, Lean UX (2013)
  • Teresa Torres, Continuous Discovery Habits (2021)

Related skills

FAQ

What is the XYZ hypothesis format?

At least X% of Y will do Z, a falsifiable statement with a success threshold, target population, and measurable action.

What experiment methods does it cover?

For new products: landing page, explainer video, pre-order/waitlist, concierge MVP. For existing products: fake door, feature stub, A/B test, Wizard of Oz, in-app survey.

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.