experiment-design

Generate experiment specs with hypothesis, variants, metrics, and guardrails.

Updated Apr 19, 2026
One-click install
npx skills add https://github.com/marmikcfc/pepper-skills --skill experiment-design-marmikcfc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: experiment-design
Source: https://github.com/marmikcfc/pepper-skills/tree/main/skills/experiment-design
Command: npx skills add https://github.com/marmikcfc/pepper-skills --skill experiment-design-marmikcfc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Turn strategic bets into rigorous, runnable experiments with clearly defined hypotheses, variants, success metrics, guardrails, and execution plans.

Core Features & Use Cases

  • Converts bets into complete experiment specs including hypothesis, control, variant, primary metric, sample size, duration, and guardrails
  • Auto-generates a unique Experiment ID, owner assignment, and a concise execution plan
  • Saves and tracks specs under experiments/active for weekly strategy reviews and audits

Quick Start

Provide a bet title or paste the bet row from bets/bets.md, and the tool will generate a complete experiment spec ready for execution.

Frequently Asked Questions about experiment-design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design an experiment from a strategic bet?▼

To design an experiment from a strategic bet, you provide the bet title or paste the bet row from your strategy file. The tool then generates a complete experiment card with hypothesis, variants, metrics, sample size, duration, and guardrails.

What components are needed for a rigorous experiment design?▼

A rigorous experiment design requires a defined hypothesis, control and variant groups, primary metrics, guardrails, and a calculated sample size. It also needs an execution plan, kill criteria, decision rules, and a realistic duration estimate based on weekly throughput.

How is sample size and experiment duration calculated from weekly throughput?▼

Sample size and experiment duration are calculated by evaluating your weekly throughput. The tool uses this data to produce a realistic duration estimate and determine the necessary sample size for achieving statistical significance.

Can I create an experiment specification without a pre-existing bets file?▼

Yes, you can create an experiment specification without a pre-existing bets file by providing an inline hypothesis. The tool will auto-increment a unique experiment ID, assign an owner, and save the active spec for tracking.

What is the best way to track active experiment specs for weekly strategy reviews?▼

The best way to track active experiment specs for weekly strategy reviews is to save them in a dedicated directory. The tool automatically saves generated specs under an active experiments folder for audits and continuous tracking.