skills/sales-vwo/SKILL.md
VWO platform help — A/B testing, multivariate tests, heatmaps, session recordings, personalization, feature flags, server-side experimentation, SDKs, REST API. Use when A/B tests aren't reaching significance, visual editor is breaking your site, heatmaps aren't showing useful data, personalization rules aren't targeting correctly, feature flags need rollout strategy, MTU quota is running out, or you're comparing VWO vs Optimizely vs AB Tasty. Do NOT use for funnel strategy (use /sales-funnel) or checkout optimization strategy (use /sales-checkout).
npx skillsauth add sales-skills/sales sales-vwoInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Help the user with VWO (Visual Website Optimizer) platform questions — from A/B test setup and heatmap analysis through personalization rules, feature flags, SDK integration, and API usage.
If references/learnings.md exists, read it first for accumulated platform knowledge.
Ask the user:
Which VWO module do you need help with?
What's your situation?
What's your VWO plan? (Starter/Growth/Pro/Enterprise — affects feature availability)
If the user's request already provides enough context, skip to the relevant step. Lead with your best-effort answer, then ask 1-2 clarifying questions at the end.
If the request maps to a specialized skill, route:
/sales-funnel {your question}/sales-checkout {your question}/sales-integration {your question}Otherwise, answer directly from platform knowledge using the reference below.
Read references/platform-guide.md for the full platform reference — modules, pricing, integrations, data model, SDK setup, API overview.
Answer the user's question using only the relevant section. Don't dump the full reference.
For API questions, also read references/vwo-api-reference.md for endpoint details, authentication, and SDK documentation.
You no longer need the full platform guide — focus on the user's specific situation.
If you discover a gotcha, workaround, or tip not covered in references/learnings.md, append it there.
Best-effort from research — review these, especially items about plan-gated features and integration gotchas that may be outdated.
API access is Enterprise-only. Don't recommend REST API solutions to Growth/Pro users — they need to upgrade or use the visual editor and dashboard.
MTU quota stops tests immediately. When monthly tracked users are exhausted, all active tests and data capture halt until the next billing cycle. No overage billing — just a hard stop.
Visual editor breaks dynamic/SPA sites. The editor replaces static HTML — it can't handle React, Vue, or dynamically rendered content reliably. Recommend server-side testing or custom code for SPAs.
VWO SmartCode must load before page content. Place it synchronously in <head> to avoid flicker. Async loading causes visible content changes (flash of original content).
Bayesian statistics ≠ "call the test early." VWO uses Bayesian methods, but you still need adequate sample size. Don't declare winners with fewer than 100 conversions per variation.
VWO merged with AB Tasty (Jan 2026). Platform integration is ongoing — some AB Tasty features may appear in VWO, and pricing/packaging may change.
Heatmap data sampling. On high-traffic sites, VWO samples heatmap data rather than recording every visitor. Patterns are reliable but individual user tracking may be incomplete.
Plan-gated features change frequently. Personalization, server-side testing, and advanced analytics may require Pro or Enterprise. Always verify current plan access.
Self-improving: If you discover something not covered here, append it to references/learnings.md with today's date.
/sales-funnel — Sales funnel strategy, A/B testing priorities, conversion benchmarks, funnel structure/sales-checkout — Checkout page optimization, order bumps, cart abandonment recovery/sales-integration — Connecting VWO to CRM, analytics, and data warehouse tools/sales-do — Not sure which skill to use? The router matches any sales objective to the right skill. Install: npx skills add sales-skills/sales --skill sales-doUser: "I've been running an A/B test on my pricing page for two weeks but VWO still shows inconclusive results."
Approach: Check the test's sample size and conversion count per variation. VWO needs ~100+ conversions per variation for reliable Bayesian results. If traffic is low, recommend extending the test or testing a more impactful change (headline swap > button color). Review the test setup for proper goal configuration and check if bots are inflating visitor counts without converting.
User: "Where are people dropping off on my checkout page? I set up heatmaps but I'm not sure what to look for."
Approach: Guide through VWO Insights — set up a click heatmap and scroll map on the checkout page. Look for: clicks on non-clickable elements (confusion), scroll drop-off before the CTA (page too long or trust signals missing), rage clicks on form fields (validation frustration). Suggest pairing with session recordings filtered to checkout bounces for qualitative context.
User: "I want to roll out a new checkout flow to 10% of users first, then gradually increase."
Approach: Set up a feature flag in VWO FME with a percentage-based rollout rule. Install the appropriate SDK (Node.js, Python, etc.), initialize with the account ID and SDK key, evaluate the flag at runtime. Start at 10%, monitor error rates and conversion, bump to 25% → 50% → 100%. Use environment-specific rules for staging vs production.
<head> and load synchronously. Use VWO's Chrome extension to debug.tools
Waitlister platform help — pre-launch waitlist platform with hosted landing pages, points-based viral referrals, built-in email broadcasts, REST API, and five HMAC-signed webhook events. Use when choosing Free (100 subscribers) vs Launch $15/mo (unlimited subs, referrals + broadcasts) vs Growth $49/mo (API, webhooks, Klaviyo/Mailchimp/Kit sync, fraud detection unlock here) vs Business $129/mo, building a webhook handler that verifies X-Webhook-Signature, webhooks auto-disabled after 10 consecutive failures, API signups bypassing referral fraud detection because client_ip/fingerprint weren't forwarded, granting bonus points or pulling top referrers via the API for reward fulfillment, broadcast send caps forcing an ESP handoff, automating without Zapier (Waitlister has none — webhooks/API only), or comparing Waitlister vs LaunchList/KickoffLabs/GetWaitlist/Prefinery. Do NOT use for list-growth strategy (use /sales-audience-growth) or LaunchList help (use /sales-launchlist).
development
LaunchList platform help — viral pre-launch waitlist platform with one-time lifetime pricing, gamified referrals (queue jumping, leaderboard, position inflation), embed widget + custom form POST endpoint, new_user/email_verify webhooks, Zapier, and spam protection. Use when choosing Free (100 submissions) vs Launch $29 (500) vs Grow $79 one-time (10K — webhooks, Zapier, team unlock here), wiring waitlist signups into Mailchimp/Kit/HubSpot or a CRM because LaunchList has no email broadcast system, needing programmatic access when there is no public REST API yet (form POST + webhook workaround), building a webhook handler with referred_by referral attribution, blocking disposable-email or bot signups on a viral waitlist, a custom signup form not submitting or not tracking referrals, or comparing LaunchList vs KickoffLabs/Viral Loops/Prefinery/GetWaitlist on one-time vs subscription pricing. Do NOT use for list-growth strategy (use /sales-audience-growth) or KickoffLabs help (use /sales-kickofflabs).
development
UpViral platform help — viral referral marketing and list-building platform (by Emarky) for viral sweepstakes, giveaway/reward campaigns, pre-launch waiting lists, and milestone referrals, with REST API (`app.upviral.com/api/v1/`, form-encoded `uvapikey` + `uvmethod`), Callback-URL webhooks, IP-based fraud detection, and 30+ ESP/CRM integrations. Use when campaigns aren't tracking referral points, deciding between Starter $79/mo (10K leads, NO API) vs Business $119/mo (API + webhooks) vs Premium $319/mo, the API erroring because you're on Starter where API/webhooks are gated, building a pipeline with `add_contact`/`get_leads`/`get_leads_points`, interpreting same-IP suspicious-referral flags, or picking UpViral over Viral Loops/Vyper/Gleam. Do NOT use for newsletter audience growth (use /sales-audience-growth), KickoffLabs help (use /sales-kickofflabs), merge-tag referrals (use /sales-referralkit), SparkLoop recommendations (use /sales-sparkloop), or multi-level Level 1/2/3 tracking (use /sales-referralhero).
tools
ReferralHero platform help — full-stack referral, affiliate, waitlist, contest, and NPS platform with REST API, webhooks, Zapier, native ESP connectors, multi-level referral tracking (Level 1/2/3), coupon groups, anti-fraud, and a 5,000 calls/hour limit. Use when referrals aren't tracking, deciding between Free (no API) vs PRO $199/mo (API + webhooks) vs PREMIUM $399/mo (ReCaptcha + SMS Verification), auth failing with `no_token` or `Bearer` vs `X-API-Key`, Level 2/3 counts off from calling `level_2_all_referrals` not `level_2_referrals`, bulk 429s from not chunking the 500-transaction `add_bulk_transactions` limit, coupon endpoints 404 without a coupon group, reward fulfillment (`promote` then `unlock_promoted_reward`) failing, or comparing to SparkLoop/ReferralKit/GrowSurf. Do NOT use for newsletter audience growth (use /sales-audience-growth), merge-tag referrals (use /sales-referralkit), SparkLoop recommendations (use /sales-sparkloop), or affiliate strategy across tools (use /sales-affiliate-program).