Generated banner for Content Experimentation Best Practices
Generated logo for Content Experimentation Best Practices

Content Experimentation Best Practices

SanityOfficialPublished by Sanity

  • Skill
  • Guidelines
  • Business and productivity
  • MIT
  • No issues found

From the author

Content experimentation and A/B testing guidance covering experiment design, hypotheses, metrics, sample size, statistical foundations, CMS-managed variants, and common analysis pitfalls. Use this skill when planning experiments, setting up variants, choosing success metrics, interpreting statistical results, or building experimentation workflows in a CMS or frontend stack.
— the description by Sanity

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

This skill provides a structured framework for content experimentation, covering the entire lifecycle from hypothesis generation to statistical analysis. It offers best practices for designing tests, avoiding common analytical pitfalls, and integrating experimentation workflows directly into CMS architectures. The guidance emphasizes data-driven decision-making, helping teams move beyond intuition to validate content changes through rigorous testing methodologies.

What it does

  • Defines frameworks for A/B and multivariate testing.
  • Provides patterns for integrating experiment variants into CMS schemas.
  • Outlines statistical foundations including significance and power analysis.
  • Identifies common pitfalls in experiment design, execution, and interpretation.
  • Offers guidance on hypothesis formulation and metric selection.
  • Details architectural approaches for managing variants within content platforms.

When to use it

  • When planning A/B or multivariate tests for website content.
  • When designing the schema for experiment-managed content in a CMS.
  • When troubleshooting inconclusive or suspicious test results.
  • When establishing an experimentation culture to replace opinion-based decisions.
  • When determining the required sample size for a new experiment.
  • When evaluating whether to use CMS-native variants or external platforms.

Advantages

  • Reduces the risk of false positives and invalid test conclusions.
  • Provides clear architectural patterns for CMS-based experimentation.
  • Helps teams avoid common statistical and design mistakes.
  • Promotes a systematic approach to learning from content changes.
  • Supports better collaboration between content and development teams.

Usage examples

“How should I structure my CMS schema to support A/B testing on landing page headlines?”
The skill provides specific schema examples for field-level variants or dedicated experiment documents, including fields for variant weights and status tracking.
“Why are my A/B test results fluctuating so much?”
The skill explains the 'peeking problem' and provides guidance on pre-calculating sample sizes and committing to run times to ensure statistical validity.

Install

  1. Download the skill as a ZIP:

    https://mp-staging.autogineer.com/agent-skills/sanity-io/content-experimentation-best-practices/download
  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip content-experimentation-best-practices.zip -d .agents/skills

Documentation by Sanity

Content Experimentation Best Practices

Principles and patterns for running effective content experiments to improve conversion rates, engagement, and user experience.

When to Apply

Reference these guidelines when:

  • Setting up A/B or multivariate testing infrastructure

  • Designing experiments for content changes

  • Analyzing and interpreting test results

  • Building CMS integrations for experimentation

  • Deciding what to test and how

Core Concepts

A/B Testing

Comparing two variants (A vs B) to determine which performs better.

Multivariate Testing

Testing multiple variables simultaneously to find optimal combinations.

Statistical Significance

The confidence level that results aren't due to random chance.

Experimentation Culture

Making decisions based on data rather than opinions (HiPPO avoidance).

References

Start with the reference that matches the current problem, such as design, statistics, CMS integration, or pitfalls. See references/ for detailed guidance:

  • references/experiment-design.md — Hypothesis framework, metrics, sample size, and what to test

  • references/statistical-foundations.md — p-values, confidence intervals, power analysis, Bayesian methods

  • references/cms-integration.md — CMS-managed variants, field-level variants, external platforms

  • references/common-pitfalls.md — 17 common mistakes across statistics, design, execution, and interpretation

Files

references/statistical-foundations.md

Statistical Foundations

Understanding basic statistics prevents misinterpreting experiment results.

Table of Contents

  • Key concepts

  • Sample size calculation

  • Common statistical mistakes

  • Interpreting results

  • Alternative approaches

  • When to trust results

Key Concepts

Statistical Significance

A measure of whether observed differences are likely real or due to chance.

  • p-value < 0.05: "Statistically significant" at 95% confidence

  • Means: If there were no real difference, there's less than a 5% chance of seeing results this extreme

  • Does NOT mean: The change is important or meaningful

  • Common misconception: The p-value is NOT "the probability the result is due to chance." It's the probability of observing data this extreme assuming the null hypothesis is true.

Confidence Interval

A range of plausible values for the true effect.

Example: "Conversion rate increased by 5% (95% CI: 2% to 8%)"

  • Best estimate: 5% improvement

  • Could be as low as 2% or as high as 8%

  • Narrower intervals = more certainty

Statistical Power

The ability to detect a real effect when it exists.

  • Standard: 80% power

  • Higher power = larger sample size needed

  • Low power = might miss real improvements

Minimum Detectable Effect (MDE)

The smallest improvement worth detecting.

  • Smaller MDE = larger sample size needed

  • Be realistic: Can you act on a 0.5% improvement?

Sample Size Calculation

Before running a test, calculate required sample size:

Required per variant = 16 × σ² / MDE²

Where:
- σ² = variance (for conversion rate: p × (1-p))
- MDE = minimum detectable effect (absolute)

For a 5% baseline conversion rate, detecting a 1% absolute lift (5% → 6%):

  • σ² = 0.05 × 0.95 = 0.0475

  • MDE² = 0.01² = 0.0001

  • n = 16 × 0.0475 / 0.0001 = 7,600 per variant

  • Total: ~15,200 visitors minimum

Common Statistical Mistakes

Multiple Comparisons Problem

Testing 10 variants increases false positive rate.

Solution: Adjust significance threshold (Bonferroni correction) or use sequential testing methods.

Peeking Problem

Checking results daily and stopping when significant.

Why it's wrong: Significance fluctuates. Early "winners" often regress.

Solution: Pre-commit to sample size and duration. Use sequential testing if you must peek.

Simpson's Paradox

Overall results hide segmented truths.

Example:

  • Overall: Variant B wins

  • Mobile users: Variant A wins

  • Desktop users: Variant A wins

  • How? Different traffic mix per variant

Solution: Always segment by major factors (device, traffic source).

Survivorship Bias

Only analyzing users who completed the funnel.

Solution: Include all visitors, not just converters.

Interpreting Results

Significant + Meaningful

Clear win. Implement the change.

Significant + Trivial

Statistically different but tiny effect. Consider if worth the complexity.

Not Significant + Large Effect

Might be real but underpowered. Extend the test or accept uncertainty.

Not Significant + Small Effect

No detectable difference. Either no real effect or test was underpowered.

Alternative Approaches

Bayesian A/B Testing

An alternative to traditional (frequentist) hypothesis testing. Bayesian methods provide:

  • Direct probability statements: "There's a 95% probability Variant B is better" (more intuitive than p-values)

  • No peeking problem: Continuous monitoring is built in — you can check results at any time

  • Credible intervals: Directly interpretable as "the true value falls in this range with X% probability"

Bayesian methods are offered by platforms like VWO and are useful when you need to make decisions with limited traffic or want more intuitive reporting for stakeholders.

Multi-Armed Bandits

Dynamically allocate more traffic to winning variants while still learning:

  • Thompson Sampling: Balances exploration (learning) with exploitation (serving the best variant)

  • Best for: Ongoing optimization where you want to minimize regret during the test

  • Trade-off: Faster convergence to the winner, but less statistical rigor than fixed-allocation A/B tests

Consider bandits for content recommendations, personalization, or situations where the cost of showing a losing variant is high.

Sequential Testing

For teams that need to monitor experiments continuously:

  • Group sequential designs (O'Brien-Fleming, Lan-DeMets) allow pre-planned interim analyses

  • Always-valid p-values let you check results at any time without inflating false positive rates

  • Use when you must balance the peeking problem with business pressure to act on results quickly

When to Trust Results

Checklist before declaring a winner:

  • [ ] Reached pre-calculated sample size

  • [ ] Ran for full business cycle (1-2 weeks minimum)

  • [ ] p-value < 0.05 (or your chosen threshold)

  • [ ] Effect size is meaningful for business

  • [ ] Results consistent across major segments

  • [ ] No external factors contaminated results

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Published by
Sanity
Publisher
Sanity (Official)
Source
sanity-io/agent-toolkit · skills/content-experimentation-best-practices · commit 3ed3a14
Licence
MIT License (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by Sanity.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download content-experimentation-best-practices.zip