Content Experimentation Best Practices
SanityOfficialPublished by Sanity
- Skill
- Guidelines
- Business and productivity
- MIT
- No issues found
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
Download the skill as a ZIP:
https://autogineer.com/agent-skills/sanity-io/content-experimentation-best-practices/downloadUnzip 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 testreferences/statistical-foundations.md— p-values, confidence intervals, power analysis, Bayesian methodsreferences/cms-integration.md— CMS-managed variants, field-level variants, external platformsreferences/common-pitfalls.md— 17 common mistakes across statistics, design, execution, and interpretation
Files
- ATTRIBUTION.mdAdded by AutoGineer907 B
- LICENSELicence file added by AutoGineer1.0 KiB
- SKILL.md1.8 KiB
- references/cms-integration.md6.8 KiB
- references/common-pitfalls.md6.7 KiB
- references/experiment-design.md3.1 KiB
- references/statistical-foundations.md4.9 KiB
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 or Sanity.
Download ZIP
The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download content-experimentation-best-practices.zip