Token导航 LogoToken导航TokenDH.com
研究检索需要联网github未标认证来源可访问许可证需确认审计提醒

referral-viral-loops推荐病毒循环

Agent Skill

referral-viral-loops 用于查找、检索和筛选相关信息,适合在 Codex、Claude、Cursor、Gemini CLI 中需要根据关键词、任务场景或来源线索快速定位候选结果时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态,以及是否会触发联网、命令执行或文件读写。

总安装

504

周安装

21

GitHub Stars

19

下载量

168
CodexClaudeCursorGemini CLI

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

GitHub

来源数

2

许可证

unknown

最后核验

2026-05-01

来源状态

来源可访问

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:referral-viral-loops(推荐病毒循环)
来源仓库:https://github.com/finsilabs/awesome-ecommerce-skills
仓库路径:skills/referral-viral-loops
安装命令:
npx skills add https://github.com/finsilabs/awesome-ecommerce-skills --skill referral-viral-loops
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill;本站只展示命令,不托管安装包,也不自动执行。

skills.shnpx skills
npx skills add https://github.com/finsilabs/awesome-ecommerce-skills --skill referral-viral-loops

简介

referral-viral-loops 用于查找、检索和筛选相关信息,适合在 Codex、Claude、Cursor、Gemini CLI 中需要根据关键词、任务场景或来源线索快速定位候选结果时使用。

  • 适用于研究检索类任务,如信息搜集、资料筛选和知识整理,尤其适合多源数据聚合与初步分析。
  • 通过关键词、任务描述或来源仓库提供查询条件,返回结构化候选结果列表供进一步处理。
  • 安装前建议确认权限范围、维护状态,以及是否会触发联网、命令执行或文件读写。
  • 可结合来源仓库、安装命令和原始 README 继续核验具体用法。

SKILL.md

Referral Viral Loops

Overview

Word-of-mouth referral programs are one of the lowest-cost customer acquisition channels — referred customers have 37% higher retention rates and 25% higher LTV than non-referred customers. A dual-sided referral (reward both the referrer and the new customer) typically outperforms one-sided rewards by 2–3×. Dedicated referral apps (ReferralCandy, Friendbuy, Yotpo Loyalty) handle link generation, reward fulfillment, and fraud controls without custom code.

When to Use This Skill

  • When CAC is high and word-of-mouth is underutilized
  • When existing customers frequently refer friends informally but there is no structured program to track and reward it
  • When needing to scale a referral program that has been running manually
  • When wanting to calculate K-factor and optimize the program's viral coefficient

Core Instructions

Step 1: Choose the right referral platform

PlatformBest ForShopifyWooCommerceBigCommercePrice
ReferralCandySimple setup, all major platformsApp StorePluginApp Marketplace$59+/mo
FriendbuyMid-market DTC, A/B testing rewardsApp StoreVia JSVia JS$249+/mo
Yotpo LoyaltyBrands already using YotpoApp StoreLimitedApp Marketplace$199+/mo
Smile.io ReferralsAlready using Smile.io for loyaltyApp StorePluginApp MarketplaceIncluded in $49/mo plan
RewardfulSaaS + ecommerce via StripeVia StripeVia StripeVia Stripe$49+/mo
AffiliateWPWooCommerce-nativePlugin$149/yr

Recommendation: Use ReferralCandy for most stores — quick setup, dual-sided rewards built in, fraud detection included, and competitive pricing. If you are already using Smile.io for loyalty, add their referral module instead of a separate app.

Step 2: Design your referral program structure

Before installing anything, define the reward structure:

Dual-sided reward (recommended):

  • Referrer reward: $10 store credit for every successful referral (paid after refund window)
  • Referee reward (new customer): 15% off first order, no minimum

Single-sided reward (simpler but lower share rate):

  • Referrer reward only: $15 store credit

Minimum order for referral to qualify: $30 (prevents micro-order gaming)

Refund window: Wait 7–14 days after the referee's order before granting the referrer reward — this prevents rewards on returned orders.

Step 3: Set up your referral program


Shopify with ReferralCandy

  1. Install ReferralCandy from the Shopify App Store
  2. Go to ReferralCandy → Program → Rewards and configure:

- Referrer reward: "$10 store credit" (or cash via PayPal) - Referee reward: "15% off first order" (ReferralCandy creates a unique discount code per referral link) - Minimum order: $30

  1. Go to ReferralCandy → Program → Fraud Settings and enable:

- Block self-referrals - Flag same-IP conversions for review - Set maximum referrals per customer per month (10)

  1. Go to ReferralCandy → Integrations and connect Klaviyo — this allows referral events to trigger Klaviyo flows
  2. ReferralCandy automatically:

- Generates a unique referral link per customer (e.g., yourstore.com/?via=sarah123) - Displays the referral widget on the post-purchase page - Sends referral invitation emails to new customers after purchase - Tracks clicks, signups, and conversions per referrer

  1. Go to ReferralCandy → Promote and add the referral widget to your account dashboard and post-purchase confirmation page

Shopify with Smile.io Referrals

  1. Go to Smile.io → Programs → Referrals
  2. Enable the referral program and configure:

- Referrer reward: points or store credit - Referee reward: discount code sent automatically when they click the referral link

  1. Go to Smile.io → Rewards Panel to customize how the referral link appears in the loyalty widget

WooCommerce with AffiliateWP

  1. Install AffiliateWP ($149/yr) from the WooCommerce marketplace
  2. Go to AffiliateWP → Settings → General and configure:

- Commission rate: fixed amount ($10) or percentage - Cookie expiration: 30 days (referral attribution window)

  1. Go to AffiliateWP → Affiliates → Add Affiliate to manually add customers, or enable self-registration so customers can join as affiliates
  2. AffiliateWP generates a unique affiliate link per referrer: yourstore.com/?ref=AFFILIATE_ID
  3. For referee discount: create a WooCommerce coupon code and link it to the referral program (AffiliateWP has a coupon integration add-on)
  4. For fraud controls: go to AffiliateWP → Settings → Advanced and enable IP address duplicate detection

Alternative: Install ReferralCandy for WooCommerce (plugin) for a simpler dual-sided setup.


BigCommerce with ReferralCandy

  1. Install ReferralCandy from the BigCommerce App Marketplace
  2. Configuration is identical to the Shopify setup above
  3. ReferralCandy integrates with BigCommerce's native coupon system to issue referee discount codes

Custom / Headless

Use a dedicated referral API platform like Friendbuy or Rewardful rather than building from scratch. These provide:

  • Unique referral link generation
  • Cookie-based and URL-based attribution
  • Webhook events for referral conversions
  • Fraud signal APIs

If you must build custom, the core components are:

// Generate a unique referral code per customer
async function generateReferralCode(customerId: string): Promise<string> {
  const existing = await db.referralLinks.findOne({ where: { customerId } });
  if (existing) return existing.code;

  const customer = await db.customers.findById(customerId);
  const baseCode = customer.firstName.replace(/[^a-zA-Z]/g, '').toUpperCase().slice(0, 6);
  let code = `${baseCode}${Math.floor(100 + Math.random() * 900)}`;

  while (await db.referralLinks.findOne({ where: { code } })) {
    code = `${baseCode}${Math.floor(100 + Math.random() * 900)}`;
  }

  await db.referralLinks.create({ customerId, code, clicks: 0, conversions: 0 });
  return code;
}

// Attribute referral on order completion — check cookie for referral code
async function attributeReferral(order: Order, referralCode: string | null) {
  if (!referralCode) return;

  const referralLink = await db.referralLinks.findByCode(referralCode);
  if (!referralLink) return;
  if (referralLink.customerId === order.customerId) return; // no self-referral

  // Check if this email has already been referred (one referral per email per program)
  const existing = await db.referralConversions.findOne({ where: { refereeEmail: order.customerEmail } });
  if (existing) return;

  await db.referralConversions.create({
    referralLinkId: referralLink.id,
    referrerId: referralLink.customerId,
    refereeEmail: order.customerEmail,
    orderId: order.id,
    orderValue: order.subtotal,
    status: 'pending', // set to 'approved' after 7-day refund window
  });

  // Grant referee discount immediately (e.g., store credit or discount code)
  // Schedule referrer reward 7 days after order — after refund window
}

Step 4: Promote your referral program

Highest-traffic placements:

  1. Post-purchase confirmation page — add a referral widget immediately after checkout (highest-intent moment)
  2. Transactional email — add "Give $10, Get $10" block to every order confirmation email in Klaviyo
  3. Account dashboard — show the customer's referral link and stats (how many friends referred, how much earned)
  4. Packaging insert — include a card with the customer's referral URL printed or handwritten

In ReferralCandy: go to Promote → Post-Purchase Popup to enable the automatic widget and Promote → Emails to configure referral invitation emails.

Step 5: Measure program performance

MetricTargetWhere to Find
Share rate (% of customers who refer)> 5%ReferralCandy dashboard
Referral conversion rate> 15% of clicks convertApp analytics
K-factor (share rate × conversion rate)0.3–0.5 = strong; 1.0+ = viralCalculate from share rate × conversion rate
Revenue from referred customers10–20% of total new customer revenueApp analytics
Cost per acquisition via referralUsually 40–60% below paid CACReward cost ÷ referred orders

Best Practices

  • Dual-sided rewards outperform one-sided — giving both referrer and referee a reward increases share rates by 2–3× vs. rewarding only the referrer
  • Show the referral widget on the post-purchase confirmation page — this is the highest-intent moment; customers who just had a great purchase experience are most likely to share
  • Delay referrer reward by 7–14 days — wait until the refund window passes before granting the reward; prevents fraudsters getting rewards on returned orders
  • Use store credit over discount codes for referrer rewards — store credit ties the referrer back to your brand; perceived value is higher than a percentage off
  • Set a monthly cap per customer — even legitimate customers should not earn unlimited rewards; cap at 5–10 referrals per month
  • Add a pre-filled WhatsApp or SMS share button — most customers will not manually copy and paste a link; a one-tap share button doubles share rates

Common Pitfalls

ProblemSolution
Self-referral fraud (customer creates new account to get referee discount)Enable IP-based duplicate detection; flag same-IP conversions for manual review (ReferralCandy has this built in)
Referral codes shared publicly on coupon sitesMake codes unique per referrer so bulk sharing is detectable; ReferralCandy monitors velocity automatically
Referrer reward given before order shipsAlways delay referrer reward by 7+ days; use the app's built-in reward delay setting
Low share rate despite good rewardsReduce friction — use pre-filled share messages; show the referral widget immediately post-purchase
Referred customers do not convertIncrease the referee incentive — 15% off typically outperforms 10% off for first-order conversion

Related Skills

  • @loyalty-program-optimization
  • @affiliate-program
  • @customer-retention-engine
  • @email-marketing-automation
  • @first-party-data-collection

适合场景

01

用户想查找某类 Agent Skill 时

02

需要根据任务场景推荐可安装能力包时

03

需要对比不同来源的安装命令和来源信息时

能力概览

能力 1

按任务关键词查找相关 Skills

能力 2

展示可复制的安装命令

能力 3

保留来源站点、仓库和原始说明,方便继续核验

能力 4

展示第三方安全扫描或审计结果

安装后应在对应宿主中按原始 README 的触发条件使用;具体调用方式请以来源页面和 README 为准。

平台分布

Codex

33.2%
按下载量换算56

Claude

28.61%
按下载量换算48

Cursor

19.27%
按下载量换算32

Gemini CLI

9.84%
按下载量换算17

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

可疑

权限和风险

需要联网

该 Skill 可能需要联网访问来源站点、仓库或外部 API;具体网络访问范围需要结合源码和 README 复核。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。来源安全扫描存在 warning/failed 结果,不能写成本站确认安全。当前只有一个来源,正式发布前建议补源仓库或其他目录站核验。

来源信息

继续浏览同类 Skills