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/common-pitfalls.md

Common Experimentation Pitfalls

Avoid these mistakes that invalidate results or lead to wrong conclusions.

Statistical Mistakes

1. Stopping Early (Peeking)

The problem: Checking results daily and stopping when you see significance.

Why it's wrong: Statistical significance fluctuates. At any point during a test, you might see "significance" that disappears with more data. This is called the "peeking problem" or "repeated significance testing."

The fix:

  • Pre-calculate required sample size

  • Commit to running until you reach it

  • If you must peek, use sequential testing methods that account for multiple looks

2. Underpowered Tests

The problem: Running tests without enough traffic to detect realistic effect sizes.

Why it's wrong: You'll conclude "no difference" when there actually is one—you just couldn't detect it.

The fix:

  • Calculate required sample size before starting

  • Be realistic about minimum detectable effect (can you act on a 0.5% improvement?)

  • If traffic is low, test bigger changes

3. Multiple Comparisons

The problem: Testing many variants or metrics and celebrating any that reach significance.

Why it's wrong: With 20 metrics, you expect 1 false positive at 95% confidence—by chance alone.

The fix:

  • Define ONE primary metric before starting

  • Use Bonferroni correction or similar for multiple comparisons

  • Treat secondary metrics as directional, not conclusive

4. Ignoring Segments

The problem: Only looking at aggregate results.

Why it's wrong: Simpson's Paradox—overall winner might be loser for your key segments.

The fix:

  • Always segment by device, traffic source, user type

  • Check if results are consistent across segments

  • If segments differ dramatically, investigate why

Design Mistakes

5. Testing Too Many Things

The problem: Changing headline, image, CTA, and layout simultaneously.

Why it's wrong: You won't know which change caused the result. And each variable multiplies required sample size.

The fix:

  • Test one variable at a time (A/B testing)

  • If testing multiple, use proper multivariate testing with adequate sample size

  • Prioritize highest-impact changes first

6. Vague Hypothesis

The problem: "Let's see if this new design is better."

Why it's wrong: Without a hypothesis, you can't learn WHY something worked (or didn't).

The fix:

  • State: "We believe [change] will [impact metric] because [reasoning]"

  • Even if you're wrong, you learn something

7. No Control

The problem: Changing the control during the test, or not having one.

Why it's wrong: You need a stable baseline to compare against.

The fix:

  • Never modify the control mid-test

  • If you must change it, start a new test

  • Document exactly what the control is

Execution Mistakes

8. External Contamination

The problem: Running a test during a sale, holiday, or major event.

Why it's wrong: External factors affect both variants differently, contaminating results.

The fix:

  • Avoid tests during unusual periods

  • If unavoidable, note it and extend the test past the event

  • Compare to the same period historically

9. Selection Bias

The problem: Testing on a non-representative sample (e.g., only logged-in users).

Why it's wrong: Results won't generalize to your full audience.

The fix:

  • Test on representative traffic

  • Be explicit about who's included/excluded

  • Note limitations when reporting results

10. Implementation Bugs

The problem: Variants don't render correctly, tracking fires incorrectly, assignment is biased.

Why it's wrong: You're not testing what you think you're testing.

The fix:

  • QA both variants thoroughly before launch

  • Verify tracking events fire correctly

  • Check assignment distribution matches weights

Interpretation Mistakes

11. Celebrating Trivial Wins

The problem: Implementing a change because it was "statistically significant" even though the effect was tiny.

Why it's wrong: Statistical significance ≠ practical significance. A 0.01% improvement isn't worth the complexity.

The fix:

  • Define minimum meaningful effect before starting

  • Consider implementation cost vs. benefit

  • Don't over-optimize

12. Ignoring Confidence Intervals

The problem: Only reporting point estimates ("5% improvement!").

Why it's wrong: The true effect could be anywhere in the confidence interval.

The fix:

  • Report confidence intervals: "5% improvement (95% CI: 2%-8%)"

  • Base decisions on the lower bound for conservative estimates

  • Wider intervals = more uncertainty

13. Not Documenting Learnings

The problem: Running tests but not recording what you learned.

Why it's wrong: You'll repeat mistakes, forget context, lose institutional knowledge.

The fix:

  • Document every test: hypothesis, results, learnings

  • Include what surprised you

  • Build a searchable knowledge base

Organizational Mistakes

14. HiPPO (Highest Paid Person's Opinion)

The problem: Running experiments but ignoring results when leadership disagrees.

Why it's wrong: Defeats the purpose of data-driven decision making.

The fix:

  • Get buy-in before testing that results will be honored

  • Present data clearly to stakeholders

  • Frame as "learning" not "winning/losing"

15. Testing Everything

The problem: Running experiments on trivial changes that don't matter.

Why it's wrong: Wastes resources, creates testing fatigue, delays important experiments.

The fix:

  • Prioritize tests by potential impact

  • Not everything needs a test—use judgment for low-risk changes

  • Focus experimentation resources on high-value decisions

16. Sample Ratio Mismatch (SRM)

The problem: The actual traffic split doesn't match the intended split (e.g., you expect 50/50 but observe 52/48).

Why it's wrong: SRM is a strong signal of an implementation bug — broken randomization, bot contamination, or redirect issues. Results from experiments with SRM cannot be trusted.

The fix:

  • Check the actual split ratio against expected before analyzing results

  • Use a chi-squared test to detect statistically significant mismatches

  • If SRM is detected, investigate the root cause before drawing any conclusions

  • Common causes: bot traffic, browser redirects dropping users, bucketing bugs

17. Novelty and Primacy Effects

The problem: Users react differently to new designs initially, and the effect fades over time.

Why it's wrong: Short experiments may show inflated effects that don't persist. Returning users may click more simply because something looks new.

The fix:

  • Run experiments for at least 2 full business cycles

  • Segment results by new vs. returning users

  • If possible, check whether the effect holds in the second week vs. the first

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