New: Earn 20% as an AgentAlley affiliate. Share your link and earn on every sale you refer. Join now New: Earn 20% as an affiliate. Join now

Design viral loops into your product

Viral Loop Design — Referral, Invite & Share Mechanics

by Gingiris-1031 · MIT license · ★ 82 on GitHub · updated Sep 20

Viral Loop Design — Referral, Invite & Share Mechanics cover

Design viral loops into your product — referral programs, invite systems, and share mechanics that drive exponential growth. Includes K-factor calculations and real examples from Dropbox, Slack, and Notion.

---
name: viral-marketing-playbook
description: |
  Design viral loops into your product — referral programs, invite systems, and share mechanics that drive exponential growth. Includes K-factor calculations and real examples from Dropbox, Slack, and Notion. By @WeiYipei.
source: https://github.com/Gingiris-1031/gingiris-skills/tree/main/skills/viral-marketing-playbook
tags:
  - viral-marketing
  - growth-hacking
  - word-of-mouth
  - referral-marketing
  - growth
  - user-acquisition
  - product-led-growth
  - saas
  - loops
  - claude-code
  - ai-agent-skill
  - agent-skill

Overview

本 skill 默认偏 dev / 开源 / B2B SaaS。若产品是 2C 消费品 / 教育 / 应用 / 游戏:核心指标换成 D1/D7/D30 留存、激活率、病毒系数 K(非 MRR/CAC/LTV);冷启动渠道换成垂类社区 / 短视频 / 垂直 KOL(非 PH/HN/LinkedIn)。完整 2C 适配指南 + 各国渠道公开数据见 → gingiris-seo-geo/references/2c-adaptation.md。

Manual install (npx, ZIP)
Claude Codenpx skills add Gingiris-1031/gingiris-skills --skill viral-marketing-playbook -g -a claude-code
Claude Code (manual)mkdir -p ~/.claude/skills && curl -sL https://codeload.github.com/Gingiris-1031/gingiris-skills/tar.gz/5d40bc8f4094 \ | tar -xz -C ~/.claude/skills --strip-components=2 gingiris-skills-5d40bc8f4094/skills/viral-marketing-playbook
Windows (PowerShell)New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null; Invoke-WebRequest "https://m.agentalley.io/zip/eab233b163f84e64e908/viral-marketing-playbook.zip" -OutFile "$env:TEMP\viral-marketing-playbook.zip"; Expand-Archive "$env:TEMP\viral-marketing-playbook.zip" -DestinationPath "$HOME\.claude\skills" -Force
Claude.ai / desktopDownload the ZIP and upload it under Settings → Capabilities → Skills.
Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

  • SKILL.md2.7 KB
  • _meta.json143 B
  • .clawhub/1 file · 156 B
  • references/3 files · 6.9 KB
Read the files here
Gingiris-1031/5d40bc86 files
Shared references1SKILL.md reads these from elsewhere in the repo. Not in the ZIP.Get them on GitHub ↗
SKILL.md
Show the full text70 lines

⚠️ 区分 B2B 与 2C

本 skill 默认偏 dev / 开源 / B2B SaaS。若产品是 2C 消费品 / 教育 / 应用 / 游戏:核心指标换成 D1/D7/D30 留存、激活率、病毒系数 K(非 MRR/CAC/LTV);冷启动渠道换成垂类社区 / 短视频 / 垂直 KOL(非 PH/HN/LinkedIn)。完整 2C 适配指南 + 各国渠道公开数据见 → gingiris-seo-geo/references/2c-adaptation.md。


📦 Install

clawhub install viral-marketing-playbook

What you get after installing:

  • Viral loop anatomy — mechanics behind referral, invite, and content loops
  • K-factor math to calculate viral coefficient and model growth scenarios
  • Real case studies from Dropbox, Notion, and Loom viral engines

Viral Loop Design — Referral, Invite & Share Mechanics

🌍 Language / 语言: 中文 | English | 日本語 | 한국어

Products don't go viral by accident. This playbook teaches you to engineer virality.

  • Viral loop anatomy: The mechanics behind referral, invite, and content loops
  • K-factor math: Calculate your viral coefficient and model growth scenarios
  • Incentive design: What to offer referrers and referred users (and what doesn't work)
  • Share triggers: Moments in the user journey where sharing feels natural
  • Case studies: How Dropbox, Notion, and Loom built their viral engines

🔗 About the Author

Iris Wei — Growth consultant for 150+ AI startups. Ex-COO at AFFiNE (69K GitHub stars).

1---
2name: viral-marketing-playbook
3description: |
4 Design viral loops into your product — referral programs, invite systems, and share mechanics that drive exponential growth. Includes K-factor calculations and real examples from Dropbox, Slack, and Notion. By @WeiYipei.
5source: https://github.com/Gingiris-1031/gingiris-skills/tree/main/skills/viral-marketing-playbook
6tags:
7 - viral-marketing
8 - growth-hacking
9 - word-of-mouth
10 - referral-marketing
11 - growth
12 - user-acquisition
13 - product-led-growth
14 - saas
15 - loops
16 - claude-code
17 - ai-agent-skill
18 - agent-skill
19 - latest
20---
21 
22## ⚠️ 区分 B2B 与 2C
23 
24本 skill 默认偏 dev / 开源 / B2B SaaS。若产品是 **2C 消费品 / 教育 / 应用 / 游戏**:核心指标换成 D1/D7/D30 留存、激活率、病毒系数 K(非 MRR/CAC/LTV);冷启动渠道换成垂类社区 / 短视频 / 垂直 KOL(非 PH/HN/LinkedIn)。完整 2C 适配指南 + 各国渠道公开数据见 → `gingiris-seo-geo/references/2c-adaptation.md`。
25 
26---
27 
28## 📦 Install
29 
30```bash
31clawhub install viral-marketing-playbook
32```
33 
34**What you get after installing:**
35- Viral loop anatomy — mechanics behind referral, invite, and content loops
36- K-factor math to calculate viral coefficient and model growth scenarios
37- Real case studies from Dropbox, Notion, and Loom viral engines
38 
39---
40 
41# Viral Loop Design — Referral, Invite & Share Mechanics
42 
43> 🌍 **Language / 语言**: [中文](#中文版) | [English](references/en/README.md) | [日本語](references/ja/README.md) | [한국어](references/ko/README.md)
44 
45Products don't go viral by accident. This playbook teaches you to engineer virality.
46 
47- **Viral loop anatomy**: The mechanics behind referral, invite, and content loops
48- **K-factor math**: Calculate your viral coefficient and model growth scenarios
49- **Incentive design**: What to offer referrers and referred users (and what doesn't work)
50- **Share triggers**: Moments in the user journey where sharing feels natural
51- **Case studies**: How Dropbox, Notion, and Loom built their viral engines
52 
53## Related Gingiris Skills
54- Full version: https://clawhub.ai/gingiris-1031/skills/gingiris-launch
55- All skills: https://clawhub.ai/gingiris-1031
56- Follow: [@WeiYipei on X](https://x.com/WeiYipei)
57 
58 
59---
60 
61## 🔗 About the Author
62 
63**Iris Wei** — Growth consultant for 150+ AI startups. Ex-COO at AFFiNE (69K GitHub stars).
64 
65- 🐦 Twitter: [@WeiYipei](https://twitter.com/WeiYipei) — Daily growth tactics
66- 💬 Consulting: [@Iris_carrot on Telegram](https://t.me/Iris_carrot)
67- 🛒 Premium Bundle (all 5 playbooks + templates): [Get on Gumroad ($249)](https://gingiris.gumroad.com/l/gingiris-complete-global-launch-bundle)
68- 📚 40+ Free Playbooks: [gingiris.tools/skills](https://gingiris.tools/skills/)
69 
70 
View all files on GitHub →

Details

Updated
Sep 20, 2026
License
MIT
Stars on the repo
★ 82
Checked
Source
Gingiris-1031/gingiris-skills ↗
Creator
Gingiris-1031 · 26 listings
View creator

Similar skills

See all →
SkillReverse engineer native, managed, Electron/JavaScriptREAmorluto/rea · by morlutoReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.★ 316k GitHub starsSkillBrainstorms ideas into designs before any creative workBrainstorming Ideas Into Designsobra/superpowers · by obraYou MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.★ 290k GitHub starsSkillRequires technical rigor and verificationCode Review Receptionobra/superpowers · by obraUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation★ 290k GitHub starsSkillDiagnosis loop for hard bugs and performance regressionsDiagnosing bugsmattpocock/skills · by mattpocockDiagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.★ 267k GitHub starsSkillImplement the result of /to-spec and /to-tickets in codeImplement specmattpocock/skills · by mattpocockImplement the result of /to-spec and /to-tickets in code.★ 267k GitHub starsSkillWriting a PR bodymattpocock/skills · by mattpocockUse when writing a PR body.★ 267k GitHub stars

More from Gingiris-1031

SkillLaunch your AI product to global attentionAI Product Launch PlaybookGingiris-1031/gingiris-skills · by Gingiris-1031Launch your AI product to global attention — the playbook behind Manus, Devin, and AFFiNE's breakout launches. Covers AI-specific GTM strategy, hype cycle management, waitlist tactics, and multi-market rollout for maximum day-one impact.★ 82 GitHub starsSkillBeginner-friendly App Store Optimization guide coveringApp Store Optimization Basics — Keywords, Screenshots & RatingsGingiris-1031/gingiris-skills · by Gingiris-1031Beginner-friendly App Store Optimization guide covering keyword research, screenshot design, rating management, and A/B testing for iOS and Android. By @WeiYipei — practical ASO for indie developers and small teams.★ 82 GitHub starsSkillComplete B2B marketing pipeline combining LinkedIn contentB2B Marketing Playbook — LinkedIn + Cold Email + Webinar PipelineGingiris-1031/gingiris-skills · by Gingiris-1031Complete B2B marketing pipeline combining LinkedIn content, cold email sequences, and webinar funnels. Designed for SaaS founders doing $0–$1M ARR who need predictable lead generation. By @WeiYipei.★ 82 GitHub starsSkillBuild and grow developer and user communities from scratchCommunity Building Playbook — Developer & User Community GrowthGingiris-1031/gingiris-skills · by Gingiris-1031Build and grow developer and user communities from scratch — covering ambassador programs, community-led growth (CLG), event operations, content strategy, and health metrics. Grounded in real playbooks from Notion, Lovable, AFFiNE, ClickUp, Asana, and Lark. Use when: building a community for an open-source project, SaaS product, or brand; recruiting and managing ambassadors or community leaders; planning community events (online/offline meetups, AMAs, hackathons); designing ambassador tier/points systems; setting community health KPIs; launching a Build-in-Public strategy; setting up Discord, Slack, or Lark communities; running developer relations (DevRel); or when the user asks about community operations, ambassador programs, CLG, user advocacy, KOC/KOL cultivation, UGC flywheels, community monetization, or any variation of "how do I grow my community".★ 82 GitHub starsSkillComplete developer marketing playbook covering DevRelDeveloper Marketing Playbook — DevRel, Docs & Community FunnelsGingiris-1031/gingiris-skills · by Gingiris-1031Complete developer marketing playbook covering DevRel programs, documentation as marketing, API developer experience, community building, and hackathon strategy. For dev-tool founders who need to reach engineers. Follow @WeiYipei on X.★ 82 GitHub starsSkillBuild and measure Developer Relations programsDevRel Playbook — Developer Activation, Community and RevenueGingiris-1031/gingiris-skills · by Gingiris-1031Build and measure Developer Relations programs across documentation, community, technical content, integrations, events and developer advocacy. Use when designing DevRel strategy, improving developer activation, launching an API/SDK, evaluating sponsorships, or connecting community activity to product adoption and revenue.★ 82 GitHub stars