Install
openclaw skills install bookforge-viral-loop-designerUse this skill to design a viral or referral loop for a post-PMF product by extracting the PATTERN (not the tactic) from canonical case studies — Dropbox bilateral-incentive referral, Hotmail email-signature instrumented virality, Airbnb Craigslist cross-posting, LinkedIn public-profile SEO virality — and adapting it to the user's product. Classifies the mechanism type (word-of-mouth amplification, instrumented virality, embedded referral), models K-factor (invitations × conversion rate) and cycle time, and produces a viral-loop-design.md with the loop diagram plus a referral-test-plan.md for experiment execution. Flags the viral spam trap (when sharing becomes annoying and hurts the brand). Triggers when a growth PM asks 'how do I build a referral program like Dropbox?', 'viral loop design', 'how do I make my product viral', 'referral program', 'word of mouth growth', 'K-factor', 'viral coefficient', 'invite mechanism', 'should I offer referral rewards', 'bilateral incentive', 'Hotmail email signature', 'Airbnb Craigslist hack', 'LinkedIn public profiles', or 'viral loop testing'. Also activates for 'our referral program isn't working', 'viral spam trap', or 'refer a friend program design'.
openclaw skills install bookforge-viral-loop-designerStructured design of a viral or referral loop for a post-PMF product. Classifies the mechanism type, maps the closest canonical pattern (Dropbox, Hotmail, Airbnb, LinkedIn) to the user's product, models K-factor and cycle time, and produces a loop diagram with a test plan — all grounded in pattern extraction, not tactic copying.
Use this skill when:
Prerequisites:
product-market-fit-readiness-gate to confirm before proceeding.north-star-metric-selector.Read the following before beginning:
If either document is missing critical information (no ICP, no value proposition, no growth stage), ask one targeted question before proceeding. Do not design a loop for an underspecified product — mechanism choice depends on product structure, not generic best practices.
Read product-brief.md and optional referral data. Extract:
Why: Viral loop design is downstream of product understanding. The mechanism type you choose (Step 3) depends entirely on whether the product naturally creates sharing occasions, whether it benefits from more users joining, and whether its core value can be embedded in an invite.
Evaluate whether the product has structural conditions for viral growth. Answer these three questions explicitly:
Verdict: If all three are weak, flag this explicitly. Virality is possible through
word-of-mouth amplification, but embedded referral or instrumented virality will
require heavy investment for modest returns. Recommend focusing on organic and paid
channels (see acquisition-channel-selection-scorer) and returning to viral design
after retention has stabilized further.
Why: Not every product goes viral. The mechanism must match the product's structure. Designing an embedded referral loop for a product with no network effect and no natural sharing occasion wastes engineering cycles and can damage user trust if the incentive feels misaligned.
Based on the viral capability assessment, classify the best-fit mechanism:
Word-of-Mouth Amplification
Instrumented Virality
Embedded Referral
Why: Mechanism classification determines the build complexity, the experiment sequence, and the failure modes to watch for. Choosing instrumented virality for a product without shareable output produces expensive engineering work with zero result. Choosing embedded referral for a product without incentive alignment produces low conversion and user annoyance.
Match the product to the canonical pattern that is structurally closest. Extract the pattern — the structural logic — not the tactic.
Dropbox Pattern (Bilateral Embedded Referral)
Hotmail Pattern (Passive Instrumented Virality)
Airbnb Pattern (Cross-Platform Distribution)
LinkedIn Pattern (SEO-Driven Profile Virality)
Why: Copying tactics without understanding structural logic produces failure. Dropbox worked not because bilateral incentives are magic, but because file storage benefits from more users joining, the incentive was product-native, and marginal cost was near zero. Map the structural logic — then validate fit — before committing to build.
Produce a written loop diagram (steps with arrows) and a K-factor model.
Loop diagram format:
[Trigger] → [Share Action] → [Recipient Exposure]
→ [Recipient Conversion] → [New User Activates] → [Loop Repeats]
Label each step with: who acts, what they do, where friction exists, and the drop-off risk at each transition.
K-factor model (fill in estimates before any engineering is committed):
K = (avg invites per active user) × (invitation-to-signup conversion rate)
Virality = Payload × Conversion Rate × Frequency
K > 1.0 — compounding (rare); K 0.5–1.0 — strong supplement; K < 0.1 — redesign first
Cycle time: How many days from signup to first invite sent? Shorter cycles compound faster than a higher K with long cycles.
Why: Teams that skip modeling discover after building that K = 0.048 and wonder why growth did not change. Model first — the estimates reveal whether the mechanism is worth building or whether the incentive needs redesigning before engineering begins.
Choose the lowest-cost test that validates the most important assumption in the loop.
Hierarchy of testability (cheapest first):
Specify: hypothesis ("If we offer [incentive] to both parties, [X]% of active users will send at least one invite within 14 days"), success K threshold, and three metrics to track: referral send rate, referral-to-activation rate, time-to-first-invite.
Why: Dropbox discovered the collaboration framing outperformed the storage framing only through testing — not predictable in advance. LinkedIn found four invites optimal vs. two or six through experiment. Building the full system before testing the incentive produces an expensive loop with an unvalidated conversion assumption at its core.
Explicitly assess whether the proposed loop design risks crossing from helpful to annoying. Check all three signals:
Spam trap indicators:
Rules:
Why: BranchOut bypassed Facebook's invite limit and grew from 4M to 25M users in three months through engineered viral spam. Then lost 4%+ of monthly active users per day as users experienced a hollow product and their spammed contacts never engaged. Despite $50M in funding, BranchOut never recovered. The viral spam trap compounds: every spammed contact is a burned conversion opportunity and a brand impression that signals low quality.
Write two files:
viral-loop-design.md — Contains:
referral-test-plan.md — Contains:
Why: Separating the design document from the test plan allows the design to be reviewed and revised independently of the experiment setup — and allows the experiment to be handed to an engineer or growth PM who doesn't need to re-read the full design reasoning to set up the test.
Virality requires product-level fit — not every product goes viral. Network-effect and sharing-native products have structural virality advantage. Products without these characteristics can still grow through word-of-mouth, but embedded referral loops will underperform unless the product is genuinely must-have and the incentive is deeply product-native.
Bilateral incentives consistently outperform unilateral. If only the referrer benefits, the referral is a transaction the recipient did not agree to. If both parties benefit, the referrer is doing their contact a favor. The social dynamic changes from extraction to generosity, and conversion improves accordingly. Dropbox's bilateral storage offer worked because both sides received something they genuinely wanted — not a promotional discount on something they hadn't asked for.
Cycle time compounds — shorter cycles beat bigger incentives. A K of 0.6 with a 3-day cycle time produces more compounding over 90 days than a K of 0.8 with a 25-day cycle time. Invest in reducing the time from new-user-signup to first-invite-sent. Friction in the share flow (too many steps, unclear incentive, buried UI) extends cycle time. Visibility and integration (Uber's referral prompt on the active ride screen, LinkedIn's connect prompt at sign-up) compresses it.
K > 1 means compounding growth; K < 1 is an acquisition supplement, not an engine. K > 1.0 is rare and typically short-lived. A K of 0.5 consistently is excellent — it means 50% of your growth comes from the loop. Communicate this clearly with leadership. "Referral" does not mean "free growth that replaces paid acquisition" — it means one cost-efficient acquisition channel that should be part of a diversified mix.
The viral spam trap destroys brand faster than it acquires users. Every spammed contact is a burned conversion and a negative brand impression. Dark patterns (pre-checked contact lists, deceptive invite copy, forced bulk sharing) produce short-term volume spikes and long-term brand damage. BranchOut is the named cautionary case. Measure recipient activation rate before scaling invite volume; if it is below 5%, improve the incentive quality, not the send frequency.
Extract the pattern, not the tactic — then validate the fit. Dropbox's bilateral storage incentive worked because of four specific structural conditions: collaborative product, network effect, product-native incentive, near-zero marginal cost. Copying the bilateral incentive structure without those conditions produces an expensive referral program with low conversion. Map the structural logic to your product before committing to any mechanism.
Product: A post-PMF project management SaaS. Teams use it together — inviting teammates is a natural part of onboarding. Network effect is strong: more team members using it makes it more valuable for the person who invited them.
Viral capability assessment: GREEN. Strong network effect (collaborative by design). Natural sharing occasion (teammate invitation is required for core use). Incentive alignment possible (free seats / extra storage / premium features as reward).
Mechanism type: Embedded Referral (bilateral incentive).
Pattern match: Dropbox. The product is collaborative; getting others on the platform improves the referrer's experience; giving away additional seats has near-zero marginal cost at volume.
Loop diagram:
[User A joins and activates] → [Prompted to invite teammates during onboarding]
→ [Teammate receives email with credit offer for both A and teammate]
→ [Teammate signs up, activates, experiences aha moment]
→ [Teammate is prompted to invite their own team members]
→ [Loop repeats]
K-factor model:
Cycle time: ~7 days (invite sent day 1, teammate activates by day 7 on average).
First experiment: Test the incentive without building the full system. Email the top 20% most active users. Offer one extra seat free (bilateral: both users get the seat) if they invite a teammate this week. Track invite send rate and acceptance rate. Success threshold: ≥ 30% invite rate from active users contacted, ≥ 15% teammate acceptance. If below threshold, test a premium feature unlock instead.
Spam trap check: PASS. Invite is addressed to specific teammates by name. Recipient receives a clear benefit. No dark patterns. Activation rate from teammates is expected to be high because they are already working with the referrer.
Product: A platform where professionals publish articles and case studies. Each article is a public page. Non-users can read articles without signing up. The platform has no social graph or network effect — reading an article is not improved by more users joining.
Viral capability assessment: YELLOW. No network effect. Strong natural sharing occasion (articles are meant to be shared). Incentive alignment is weak (bilateral storage/credits feel disconnected from publishing). Instrumented virality is a better fit than embedded referral.
Mechanism type: Instrumented Virality (LinkedIn pattern + Hotmail pattern hybrid).
Pattern match: LinkedIn public profiles. Every published article is already a public page. The growth action is to make those pages fully searchable and to embed a conversion call-to-action for non-authenticated readers.
Loop diagram:
[User A publishes article] → [Article is indexed by search engines (SEO surface)]
→ [Non-user B finds article via Google search]
→ [Non-user B reads article → sees "Write your own case study" CTA with free account]
→ [Non-user B signs up and publishes their first article]
→ [Article is indexed → new loop pass begins]
K-factor model (adapted — this is SEO-driven, not invite-driven):
Cycle time: Long (3–6 months for new articles to rank meaningfully). Invest in on-page SEO optimization of article templates to compress this.
First experiment: Enable public indexing for the top 100 most-viewed articles. Check Google Search Console in 30 days for impressions and clicks. Success threshold: ≥ 500 new organic sessions to those articles within 30 days. If yes, make all articles public by default and instrument the "sign up to publish" CTA prominently on article pages.
Spam trap check: NOT APPLICABLE. This loop has no invite mechanism and generates no unsolicited contact. Monitor for content quality degradation as sign-ups increase — a different quality trap, not a spam trap.
references/viral-loop-mechanics.md — Detailed K-factor formula derivations, Sean
Parker's virality equation (Payload × Conversion Rate × Frequency), and cycle time
compounding models.references/case-study-patterns.md — Full structural analysis of the Dropbox,
Hotmail, Airbnb, and LinkedIn patterns with applicability criteria.references/viral-spam-trap.md — Detailed BranchOut case study, dark pattern
taxonomy, and detection checklist with metric thresholds.This skill is licensed under CC BY-SA 4.0. Source book content is referenced under fair use for educational purposes. Attribution: Ellis, Sean and Brown, Morgan. Hacking Growth. Crown Business, 2017.
clawhub install bookforge-acquisition-channel-selection-scorer — viral loops are
one acquisition channel category; score them against organic and paid alternatives
before committing engineering resources.clawhub install bookforge-north-star-metric-selector — viral loops must compound
the North Star Metric, not a vanity metric like invites sent or accounts created.clawhub install bookforge-product-market-fit-readiness-gate — virality on a
product that people don't find must-have accelerates churn, not growth. Confirm PMF
before designing any viral loop.clawhub install bookforge-growth-experiment-prioritization-scorer — use the
experiment scorer to rank the viral loop experiment against other growth bets in
the team's backlog before committing build resources.