A/B Test Design Brief

SkillMonitoring & ops

Build product A/B test briefs with hypotheses, success metrics, guardrails, baselines, proxy metrics, eligibility, variants, randomization, confidence, and launch criteria. Use when planning an A/B test from a product idea, writing an experiment spec, defining test/control variants, choosing metrics, or checking whether an experiment is ready to run.

Use A/B Test Design Brief in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add A/B Test Design Brief and connect your AI. About a minute.

Also: Claude Code · Cursor · Codex

Then ask your AI: use the A/B Test Design Brief skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

A/B Test Design BriefStart free

What this skill tells your AI

The instructions your AI receives, as published by hashgraph-online/awesome-codex-plugins in plugins/LVTD-LLC/skills/skills/ab-test-design-brief/SKILL.md and read by ahel’s review.

Use this skill to turn a product change into a decision-ready A/B test brief. It focuses on experiment anatomy: hypothesis, metrics, baselines, variants, eligibility, randomization, confidence, and launch criteria.

Source Traceability

Primary source: Practical A/B Testing by Leemay Nassery. Guidance is transformed and paraphrased from chapter 2, especially "Creating a Clear Hypothesis" through "Summarizing the For You A/B Test" in the working text analysis at lines 1203-1942. Related motivation and variant examples come from chapter 1 lines 394-718.

Related Advanced Skills

  • experiment-sensitivity-optimization: use when the brief is blocked by MDE, sample size, noisy metrics, CUPED, capping, or too many variants.
  • experiment-verification-monitoring: use when the brief needs prelaunch QA, canaries, exposure validation, or active experiment health checks.
  • long-term-impact-evaluation: use when the brief needs delayed or sustained impact measurement beyond the initial test window.

Reference Routing

NeedRead
Concepts and terminologyreferences/core/knowledge.md
Design rules and readiness checksreferences/core/rules.md
Brief examples and anti-examplesreferences/core/examples.md
Step-by-step brief creationworkflows/create-ab-test-brief.md

Workflow

  1. State the product decision the test must inform.
  2. Write a hypothesis with observation, predicted change, audience, and metrics.
  3. Choose one primary success metric plus guardrail metrics.
  4. Establish the baseline or explain why a proxy metric is being used.
  5. Define eligibility, exposure, test variant, and control variant.
  6. Choose the randomization unit that preserves a coherent user experience.
  7. Record confidence requirements, sample-size assumptions, and launch criteria.

Output Format

# A/B Test Brief

## Decision
[What decision this test will support.]

## Hypothesis
Because [observation], we believe [change] will cause [outcome] for [audience].
We will know this is true when [primary metric] changes without harming [guardrails].

## Metrics
| Metric | Role | Baseline | Target or Concern | Data Source |
|--------|------|----------|-------------------|-------------|

## Variants and Eligibility
- Population:
- Eligibility criteria:
- Exposure event:
- Control:
- Test:
- Randomization unit:

## Confidence Plan
- Minimum detectable effect:
- Sample size or duration:
- Risks to validity:

## Launch Criteria
- Ship if:
- Do not ship if:
- Investigate if:

Quality Bar

  • Do not accept a vague "see what happens" experiment.
  • Do not let proxy metrics hide missing instrumentation; name the compromise.
  • Do not generalize beyond the population that was eligible and exposed.
  • Keep variants interpretable: if many things change, the learning becomes weak.

Signals

GitHub stars
1k
Forks
316
Last commit
Oct 2026
Advanced
Item type
skill
Key
ab-test-design-brief
Source
github.com/hashgraph-online/awesome-codex-plugins