agentleFS
matteotittamatteotitta/claude-marketing-website/skills/ab-testing/SKILL.md

ab-testing

Skill1 starsChanged 30 days agoMITView on GitHub

Designs A/B tests that give results you can trust. Writes the hypothesis in a fixed form, scores the backlog by impact, confidence and ease, works out the sample size each variant needs, commits to the duration and the success metric before launch, and keeps each variant to one change. Use when someone says "A/B test", "split test", "test this headline", "experiment design", "sample size", "how long should we run this test" or "is this result significant".

40 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use free-tools, popups and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • CesarjoquinSkill

    free-tools

    When the user wants to plan, evaluate, or build a free tool for marketing purposes — lead generation, SEO value, or brand awareness. Also use when the user mentions "engineering as marketing," "free tool," "marketing tool," "calculator," "generator," "interactive tool," "lead gen tool," "build a tool for leads," "free resource," "ROI calculator," "grader tool," "audit tool," "should I build a free tool," or "tools for lead gen." Use this whenever someone wants to build something useful and give it away to attract leads or earn links. For downloadable content lead magnets (ebooks, checklists, templates), see lead-magnets.

    Also in 20 projects that use this

  • CesarjoquinSkill

    popups

    When the user wants to create or optimize popups, modals, overlays, slide-ins, or banners for conversion purposes. Also use when the user mentions "exit intent," "popup conversions," "modal optimization," "lead capture popup," "email popup," "announcement banner," "overlay," "collect emails with a popup," "exit popup," "scroll trigger," "sticky bar," or "notification bar." Use this for any overlay or interrupt-style conversion element. For forms outside of popups, see cro. For general page conversion optimization, see cro.

    Also in 18 projects that use this

  • coreyhaines31Skill

    marketing-council

    When the user wants multiple expert perspectives on a marketing question — a simulated board of advisors staffed by legendary marketers (Seth Godin, David Ogilvy, Eugene Schwartz, April Dunford, Rory Sutherland, Alex Hormozi, Byron Sharp, and more). Also use when the user mentions 'marketing council,' 'board of advisors,' 'advisory board,' 'what would Seth Godin say,' 'what would Ogilvy think,' 'channel Hormozi,' 'get multiple perspectives,' 'debate this,' 'have the council review,' 'marketing mentors,' or asks how a famous marketer would approach their problem. The council gives each advisor's take through their documented frameworks, surfaces where they disagree, and synthesizes a recommendation. For executing the winning direction, hand off to positioning, offers, copywriting, ads, or the relevant skill.

    Also in 13 projects that use this

  • roerohanSkill

    emails

    When the user wants to create or optimize an email sequence, drip campaign, automated email flow, or lifecycle email program. Also use when the user mentions "email sequence," "drip campaign," "nurture sequence," "onboarding emails," "welcome sequence," "re-engagement emails," "email automation," "lifecycle emails," "trigger-based emails," "email funnel," "email workflow," "what emails should I send," "welcome series," or "email cadence." Use this for any multi-email automated flow. For cold outreach emails, see cold-email. For in-app onboarding, see onboarding.

    Also in 21 projects that use this

  • roerohanSkill

    prospecting

    When the user wants to find, qualify, and build a list of prospects to reach out to — across B2B SaaS, general B2B, or local small businesses. Also use when the user mentions "prospecting," "build a prospect list," "find prospects," "find leads," "lead gen list," "find SaaS companies that," "find B2B companies," "find local businesses," "ICP-fit accounts," "who should we go after," "outbound list," "target account list," "find clients near me," "businesses without websites," "prospect research," "qualified leads," "find my first customers," "early adopters," "design partners," "beta users," or "who has this problem." Use this for the list-building and qualification phase. For writing the outbound copy after the list is built, see cold-email. For deep competitive research on specific accounts, see competitor-profiling.

    Also in 16 projects that use this

  • +7 more from Cesarjoquin

The file

We split this skill into the rules it gives an agent

2 rules. 0 are common, 2 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 38 edited versions we read keep these.

  • 2

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Pre-commit: Write down the sample size, end date, primary metric, two or three secondary metrics, and one or two guardrail metrics that …

    line 34
  2. Distinctive:

    Run without peeking: Check only that data is flowing and events fire.

    line 36

“Common” is measured: kept by at least 6 in 10 of the 38 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

A/B testing

Design tests that produce winners which hold up after launch. The discipline is simple and usually skipped: one change, a sample size decided in advance, a fixed duration, and no peeking.

When to use it

  • Testing a headline, CTA, pricing page layout, signup form field or email subject line.
  • Choosing which of several ideas to test first.

Don't test when traffic is too low to reach the sample size within about two months, when the idea has no observation behind it, when the change is cheap to reverse (just ship it and watch), or when you'd be changing several things at once.

Inputs

  • The page or flow, and its current conversion rate (baseline).
  • Monthly traffic to that page or flow.
  • The observation behind the idea: analytics, a /website-score finding, user feedback, sales objections.
  • context/goals/ if you have it: so the success metric ties to what the business actually tracks.
  • context/brand/: your brand tokens if you have them, so the variant changes only the thing being tested.

Agency users: swap context/ for clients/<client>/context/. If you don't have the baseline or traffic, ask for them. Without both, you can't size the test, so say so rather than guess.

Steps

  1. Write the hypothesis in this form: "Because {observation}, we believe {one change} will cause {outcome, with direction and size} measured by {metric} within {timeframe}." Every part is required. Produces: one hypothesis per idea.
  2. Score the backlog. Rate each idea 1 to 10 on impact (how much it moves the metric if true), confidence (how sure you are) and ease (how fast to ship and measure). Multiply the three. Test the highest first, and run no more than one or two tests per traffic source at a time. Produces: a ranked list.
  3. Size the test with the table below, or any online sample size calculator at 80% power and 95% confidence. Divide by daily traffic per variant to get the duration. Over two months means don't test. Produces: a sample size and a duration.
  4. Pre-commit. Write down the sample size, end date, primary metric, two or three secondary metrics, and one or two guardrail metrics that must not get worse (bounce rate, activation, revenue per visitor). Produces: a test plan, dated, before launch.
  5. Design the variant. The control stays as it is. Variant B changes one element only, with everything around it identical, including colours, fonts and spacing. Produces: a spec or mockup per variant.
  6. Run without peeking. Check only that data is flowing and events fire. Don't read results until the sample size is reached. Produces: a clean run.
  7. Call the result. p under 0.05 is a result; above it is inconclusive, not a loser. Then ask if the lift is worth it in real terms, and check the guardrails. A win that breaks a guardrail is a loss. Produces: winner, loser or inconclusive, with the reason.
  8. Record the learning, win or lose: hypothesis, planned and actual sample size and dates, result, absolute and relative lift, and what to test next. Keep these in one running log. Produces: a log entry.

Sample size per variant (80% power, 95% confidence, 50/50 split)

Baseline conversionLift you want to detectVisitors per variant
10%50%about 550
10%25%about 2,200
5%25%about 4,700
3%25%about 8,400
1%25%about 26,000
1%10%about 150,000

What good looks like

  • The hypothesis names a real observation and a predicted size of effect.
  • The plan was written and dated before the test went live.
  • Across many tests, 20 to 30% produce a winner. Much higher means your ideas are too safe; much lower means they're not grounded in evidence.

Mistakes to avoid

  • Stopping the test the moment it looks significant. That's how false winners happen.
  • Changing headline, image and CTA together, then not knowing which one worked.
  • Picking the success metric after seeing the results.
  • Ignoring guardrails: a better click rate that lowers signups is a loss.
  • Calling an inconclusive test a failure and dropping the idea without a note.

Output

Save to outputs/website/MMYY-ab-test-<name>.md:

# A/B test: <name>
Hypothesis: Because ..., we believe ... will cause ... measured by ... within ...
ICE: I _ x C _ x E _ = _
Baseline: _%   Lift to detect: _%   Sample per variant: _   Duration: _ days (ends <date>)
Primary metric: ...   Secondary: ...   Guardrails: ...
Control: ...   Variant B (one change): ...
Result (after end date): winner / loser / inconclusive, lift, learning, next test

Attribution

Adapted from the ab-testing skill in coreyhaines31/marketingskills (MIT, Corey Haines), including the sample size table: https://github.com/coreyhaines31/marketingskills

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.