sales-skills/sales-referralkit
skills/sales-referralkit/SKILL.md
ReferralKit platform help — newsletter referral program tool by Copyhackers with milestone-based rewards, unique-link insertion into email body, and direct ESP integrations (Mailchimp, ConvertKit/Kit, MailerLite, AWeber) for no-code newsletter operators who want a Morning Brew / The Hustle style referral engine. Use when comparing ReferralKit's free-for-first-10K-leads model against SparkLoop, ReferralHero, Viral Loops, or GrowSurf for newsletter referral programs, can't decide whether ReferralKit's ESP-native link insertion is enough or you need a richer dashboard (GrowSurf) or paid recommendations (SparkLoop), wondering whether the 10K free-lead allowance is per-list or per-account, your ESP isn't listed natively (Drip, Ghost, Campaign Monitor, ActiveCampaign — planned but not live) and need a workaround, milestone rewards aren't triggering or the unique-link merge tags aren't rendering in your email body, trying to track referrals without a public API or webhooks, or unsure if the domain is referralkit.co or referralkit.io (the .io version is dead — use .co). Do NOT use for general newsletter audience growth strategy across all platforms (use /sales-audience-growth) or general newsletter monetization (use /sales-newsletter).
$ install --global
skillsauthnpx skillsauth add sales-skills/sales sales-referralkitInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 31, 2026, 2:14 AM36.4s3 files scanned
SKILL.md
- name:
- sales-referralkit
- description:
- ReferralKit platform help — newsletter referral program tool by Copyhackers with milestone-based rewards, unique-link insertion into email body, and direct ESP integrations (Mailchimp, ConvertKit/Kit, MailerLite, AWeber) for no-code newsletter operators who want a Morning Brew / The Hustle style referral engine. Use when comparing ReferralKit's free-for-first-10K-leads model against SparkLoop, ReferralHero, Viral Loops, or GrowSurf for newsletter referral programs, can't decide whether ReferralKit's ESP-native link insertion is enough or you need a richer dashboard (GrowSurf) or paid recommendations (SparkLoop), wondering whether the 10K free-lead allowance is per-list or per-account, your ESP isn't listed natively (Drip, Ghost, Campaign Monitor, ActiveCampaign — planned but not live) and need a workaround, milestone rewards aren't triggering or the unique-link merge tags aren't rendering in your email body, trying to track referrals without a public API or webhooks, or unsure if the domain is referralkit.co or referralkit.io (the .io version is dead — use .co). Do NOT use for general newsletter audience growth strategy across all platforms (use /sales-audience-growth) or general newsletter monetization (use /sales-newsletter).
- argument-hint:
- [describe what you need help with in ReferralKit]
- license:
- MIT
- version:
- 1.0.0
- tags:
- [sales, newsletter, referral-program, audience-growth, platform]
ReferralKit Platform Help
Step 1 — Gather context
If references/learnings.md exists, read it first for accumulated platform knowledge.
-
What are you trying to do?
- A) Decide between the Free 10K-lead tier and Premium tiers
- B) Set up a milestone-based referral program (rewards at 3 / 10 / 25 referrals)
- C) Integrate with your ESP (Mailchimp, ConvertKit/Kit, MailerLite, AWeber)
- D) Workaround for a not-yet-supported ESP (Drip, Ghost, Campaign Monitor, ActiveCampaign)
- E) Compare ReferralKit to SparkLoop, ReferralHero, Viral Loops, or GrowSurf
- F) Debug referral counts or unique-link merge tags not rendering in email
- G) Pipe referral data into a CRM despite no API
-
What's your current ESP? (Drives whether ReferralKit's native integration applies or you need a workaround.)
-
What's your subscriber count and program goal? (Drives tier choice and reward tier design.)
Skip-ahead rule: if the user's prompt already contains enough context, skip to Step 2.
Step 2 — Route or answer directly
| If the question is about... | Route to... |
|---|---|
| Newsletter audience growth strategy across all platforms | /sales-audience-growth [question] |
| Newsletter monetization strategy | /sales-newsletter [question] |
| SparkLoop platform help (paid recs, referral programs, partner network) | /sales-sparkloop [question] |
| Lettergrowth cross-promo directory | /sales-lettergrowth [question] |
| Collab Match / InboxReads / MutualGro cross-promo directories | /sales-collabmatch [question], /sales-inboxreads [question], /sales-mutualgro [question] |
| Refind CPA-based newsletter ad network | /sales-refind [question] |
| ESP setup (Kit, Mailchimp, MailerLite, AWeber) | /sales-kit [question], /sales-mailchimp [question], /sales-mailerlite [question] |
If the question is ReferralKit-specific, continue to Step 3.
Step 3 — ReferralKit platform reference
Read references/platform-guide.md for the full platform reference — feature gating, ESP integration flow, milestone reward design, comparison with alternatives, and CRM-without-API patterns.
Answer the user's question using only the relevant section. Don't dump the full reference.
Step 4 — Actionable guidance
Focus on the user's specific situation:
- Under 10K subscribers: ReferralKit's free tier covers you completely. No reason to pay for SparkLoop ($99/mo) or GrowSurf until you scale past the free allowance.
- Native ESP user (Mailchimp, Kit, MailerLite, AWeber): ReferralKit's strength is direct merge-tag insertion of the unique referral link into your existing email — no separate landing pages, no JavaScript widget. If your ESP is one of these four, set up takes minutes.
- Non-native ESP (Drip, Ghost, Campaign Monitor, ActiveCampaign): ReferralKit lists these as "planned." Until live, your workaround is to copy a generic referral URL with manual UTM tagging, or switch to a tool with broader ESP support (SparkLoop covers 25+ ESPs).
- Wrong domain: If you fetched
referralkit.ioand got connection refused, the live site isreferralkit.co. The .io domain is dead — don't bookmark it. - No API: ReferralKit has no public API, no webhooks, no Zapier. If you need referral data in your CRM, export from the dashboard manually and import to HubSpot/Salesforce, or pull tagged subscribers from your ESP downstream.
If you discover a gotcha, workaround, or tip not covered in references/learnings.md, append it there.
Gotchas
Best-effort from research — review these, especially items about plan-gated features and integration gotchas that may be outdated.
- Wrong domain everywhere. The platform is
referralkit.co—.ioreturnsECONNREFUSEDand may be a stale or squatted variant. Always paste the .co URL. - No public API, no webhooks, no Zapier/Make/MCP. Confirmed via WebSearch — no developer documentation. Pipe referral data via manual CSV export or via your ESP's subscriber-level integrations.
- Pricing model uncertainty. Homepage shows "100% free for your first 10,000 leads" but
/pricingreturns 404 and older third-party sources mention "$19/mo for 3K subs." The pricing model appears to have changed; verify current tiers with ReferralKit support before quoting numbers to stakeholders. - Only 4 ESP integrations are live. Mailchimp, ConvertKit/Kit, MailerLite, AWeber. Drip, Ghost, Campaign Monitor, and ActiveCampaign are listed as "planned" — don't assume they work.
- Merge-tag-driven, not landing-page-driven. ReferralKit injects unique referral links via ESP merge tags. If your ESP strips merge tags in certain campaign types (broadcasts vs sequences), the links won't render. Test in a sample audience before launching.
- Built by Copyhackers — strong copywriting credibility but a small product team. Feature velocity is steady but support response time may be slower than enterprise SLAs.
- Morning Brew / The Hustle case studies are marketing examples, not feature parity. Those programs used custom-built referral systems; ReferralKit gives you the same mechanics in no-code form but won't match the bespoke polish.
Related skills
/sales-audience-growth— Newsletter audience growth strategy (referrals, cross-promotion, lead magnets across all platforms)/sales-newsletter— Newsletter monetization (paid subs, sponsorships, ad networks)/sales-sparkloop— SparkLoop (paid recommendations + free recommendations + partner network, 25+ ESPs)/sales-lettergrowth— Lettergrowth (free newsletter cross-promotion directory)/sales-collabmatch— Collab Match (niche Web3/tech cross-promo)/sales-inboxreads— InboxReads (5,600+ newsletter directory + Opportunities Board)/sales-mutualgro— MutualGro (creator collaboration with AI matching + scheduled posting)/sales-refind— Refind (CPA newsletter ads + cross-promo)/sales-kit— Kit (formerly ConvertKit) platform help — primary ESP integration target for ReferralKit/sales-mailchimp— Mailchimp platform help/sales-mailerlite— MailerLite platform help/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-do -a claude-code
Examples
Example 1: Free tier vs SparkLoop decision
User says: "I have a 5,000-subscriber newsletter on Mailchimp. Should I use ReferralKit's free tier or pay for SparkLoop?" Skill does: Recommends starting with ReferralKit Free — first 10,000 leads are covered, Mailchimp is natively supported, and the merge-tag flow gets a referral program live without leaving the ESP. SparkLoop's $99/mo only pays off if you want paid recommendations revenue or the partner network — not pure referrals. Suggests upgrading to SparkLoop only after hitting the 10K free cap or wanting monetization beyond list growth. Result: User launches ReferralKit free, validates the referral mechanic, considers SparkLoop only when they need post-opt-in monetization.
Example 2: ESP not natively supported
User says: "I'm on Ghost. Can I use ReferralKit?" Skill does: Notes Ghost is listed as a "planned" integration but isn't live yet. Suggests two workarounds: (1) use ReferralKit's generic referral URL with manual UTM tags and embed the link in Ghost newsletter sends via Markdown, accepting that ESP-side merge-tag automation won't work; or (2) switch to a tool that natively supports Ghost — SparkLoop does. Recommends checking ReferralKit's roadmap for Ghost timing before committing. Result: User chooses SparkLoop for Ghost-native support, or accepts the manual-link workaround if Free tier is critical.
Example 3: Pulling referral data into a CRM without an API
User says: "How do I get ReferralKit referral counts into HubSpot for sales segmentation?" Skill does: Confirms ReferralKit has no API, no webhooks, no Zapier. Workarounds: (1) export referral data from the ReferralKit dashboard manually (weekly batch CSV → HubSpot import), or (2) tag subscribers in your ESP as "referred" at signup using ESP-side automations, then sync ESP → HubSpot via the ESP's existing CRM integration. Notes ReferralKit's roadmap doesn't mention API plans publicly. Result: User builds a manual weekly CSV export → HubSpot upsert flow.
Troubleshooting
Unique referral link not rendering in email
Symptom: Merge tag for the referral link shows as plain text or empty in the sent email Cause: ESP merge-tag context mismatch — ReferralKit's merge tags require the subscriber-level context, which some broadcast templates strip Solution: Use ReferralKit's merge tags in subscriber-targeted sends (sequences, automations) — not in unsegmented broadcasts where the subscriber context isn't bound. Test with a small audience first. If still failing, ensure the ReferralKit integration is connected to the correct ESP account and audience.
Free tier counting feels off
Symptom: Approaching the 10K free-lead cap but unsure what counts Cause: Pricing terminology has changed between historical content ("subscribers") and current homepage ("leads") — definitions may differ Solution: Contact ReferralKit support to confirm what counts toward the 10K cap (signups? referrals? both?). Don't trust third-party sources for current pricing — verify directly. Plan tier upgrades with a 20% headroom buffer.
Domain confusion — referralkit.io vs referralkit.co
Symptom: Bookmarks, old guides, or AI search results point to referralkit.io which returns connection refused
Cause: The live platform is referralkit.co. The .io domain appears stale or unrelated.
Solution: Always use referralkit.co. Update any internal docs/bookmarks. The previous skill backlog entry had .io and was wrong — corrected in this skill.
Related Skills
sales-skills/sales-upviral
tools
VerifiedTrustedCommunity
UpViral platform help — viral referral marketing and list-building platform (by Emarky) for viral sweepstakes, giveaway/reward campaigns, pre-launch waiting lists, and milestone referral programs, with REST API (app.upviral.com/api/v1/), callback-URL webhooks, PHP SDK, fraud detection (IP-based suspicious-referral flagging), A/B testing, smart leaderboards, unlockable incentives, and 30+ native ESP/CRM integrations (Mailchimp, ActiveCampaign, ConvertKit, AWeber, HubSpot, Klaviyo, Intercom) plus Zapier/Make/Pipedream/Integrately/Pabbly. Use when UpViral campaigns aren't tracking referral points correctly, deciding between Starter $79/mo annual (10K leads, 1 brand, NO API) vs Business $119/mo (25K, 2 brands, API + webhooks unlocked) vs Premium $319/mo (100K, 5 brands, dedicated account manager), the API returns errors because you're on the Starter tier where API/webhooks are gated, building an UpViral→CRM or UpViral→data-warehouse pipeline with add_contact / get_leads / get_leads_points / add_points / get_custom_fields / lists methods (uvapikey + uvmethod form-encoded POST), interpreting fraud flags where same-IP referrals get marked suspicious and you must manually activate/delete/blacklist, setting up the Callback URL (webhook) to fire on reward-unlock events, Zapier New Lead / New Reward Unlocked triggers not firing, ClickFunnels/Shopify/funnel-builder integration breaking, the drag-and-drop page builder showing broken widgets or limited customization, the setup feeling long and complicated for your first campaign, or picking UpViral over Viral Loops / KickoffLabs / Vyper / Prefinery / Gleam / KingSumo / ShortStack for a viral campaign. Do NOT use for general newsletter audience growth strategy across all platforms (use /sales-audience-growth), newsletter monetization (use /sales-newsletter), KickoffLabs-specific help (use /sales-kickofflabs), no-code merge-tag newsletter referrals (use /sales-referralkit), SparkLoop paid recommendations (use /sales-sparkloop), or full-stack multi-level Level-1/2/3 referral/affiliate tracking (use /sales-referralhero).
39SKILL.mdUpdated Jun 4, 2026
sales-skills/sales-referralhero
development
VerifiedTrustedCommunity
ReferralHero platform help — full-stack referral, affiliate, waitlist, contest, and NPS platform with subscriber API, webhooks, Zapier, Mailchimp/Kit/AWeber/Klaviyo/ActiveCampaign/SendLane connectors, coupon codes, multi-level referral tracking (Level 1/2/3), anti-fraud, and 5,000 calls/hour rate limit. Use when ReferralHero campaigns aren't tracking referrals correctly, deciding between PRO $199/mo (10K members, includes API + webhooks) and PREMIUM $399/mo (50K members, adds ReCaptcha + SMS verification), authentication is failing with no_token or X-API-Key header is being ignored, multi-level referral counts (Level 2/3) aren't appearing for downline subscribers, coupon group endpoints return 404 or coupon arrays max out, hitting the 5,000 calls/hour soft limit and getting too_many_calls 429s, the Mailchimp/Kit native integration is double-adding subscribers, webhook payloads aren't firing on confirmation events, importing Stripe customer IDs through transaction tracking, generating reward fulfillment when subscribers cross milestone thresholds (promote/unlock_promoted_reward), comparing ReferralHero against SparkLoop/ReferralKit/Viral Loops/GrowSurf/KickoffLabs for referral marketing, or routing referral data via add_bulk_transactions (500-transaction batch limit). Do NOT use for general newsletter audience growth strategy (use /sales-audience-growth), general newsletter monetization (use /sales-newsletter), no-code newsletter-only referral with merge-tag insertion (use /sales-referralkit), SparkLoop's paid recommendations or partner network (use /sales-sparkloop), or affiliate program strategy across many platforms (use /sales-affiliate-program).
39SKILL.mdUpdated Jun 4, 2026
sales-skills/sales-kickofflabs
tools
VerifiedTrustedCommunity
KickoffLabs platform help — viral marketing platform for pre-launch waitlists, bonus-entry giveaways, milestone-reward referral programs, leaderboard giveaways, and email opt-in bribes with REST API v1 + v2, server-side webhooks (in/out), KOL.js JavaScript library, AnyForm script for custom pages, fraud detection (duplicate_ip / bounced / duplidate_email flags), SMS verification add-on, native ESP integrations (Klaviyo, Mailchimp, ActiveCampaign, Brevo), website builders (Webflow, Wix, Squarespace, Weebly), Shopify, Facebook Audiences, Slack, Zapier. Use when KickoffLabs viral campaigns aren't tracking referrals correctly, deciding between Hobby $13/mo annual (500 leads/mo no A/B no reward emails) vs Premium $48/mo (2.5K + A/B + reward emails + tracking pixels) vs Business $99/mo (10K + custom email templates + custom domains + advanced reporting + 3 team) vs Enterprise $202/mo (25K + 5 team + SMS included), API key getting rejected because you embedded it in client-side JavaScript instead of server-side, can't decide whether to use v1 /subscribe vs v2 /tags/:TAG_ID/lead for lead creation, webhook payloads firing with `__fraudulent` flag and you need to interpret the duplicate_ip/bounced/duplidate_email reason codes (yes, duplidate is spelled that way in their docs), AnyForm script not posting to KickoffLabs vs native API endpoint, leaderboard endpoint returning more than 50 leads is not allowed, social_id (kid in share URLs) attribution chain breaking between v1 and v2, contest score vs lead count metrics in the webhook payload are confusing, SMS Verification only available on Premium+ as $50/mo add-on (Enterprise includes), per-month lead cap auto-upgrades at $8 per 1000 overage leads, picking between KickoffLabs and Viral Loops / UpViral / Prefinery / ReferralCandy / Voucherify for viral campaign type fit, or rate limit per tier (10-100 calls/minute) is hitting on bulk imports. Do NOT use for general newsletter audience growth strategy (use /sales-audience-growth), general newsletter monetization (use /sales-newsletter), no-code merge-tag-only newsletter referrals (use /sales-referralkit), SparkLoop paid recommendations + partner network (use /sales-sparkloop), or full-stack referral/affiliate with multi-level Level-1/2/3 tracking (use /sales-referralhero).
39SKILL.mdUpdated Jun 4, 2026
sales-skills/sales-do
development
VerifiedTrustedCommunity
Routes any sales, marketing, ad, or GTM objective to the right specialized skill and outputs the install command for that skill plus a ready-to-paste prompt packed with the user's context. Asks clarifying questions when the objective is ambiguous, then hands back a copy-paste-runnable next step. Covers prospecting, outbound cadences, deals, proposals, forecasting, deliverability, enrichment, intent, content, coaching, CRO, SEO, launch directories, newsletters, email/SMS/push marketing, chatbots, influencer marketing, social media, employee advocacy, media relations, reviews, data hygiene, B2B advertising, retargeting, affiliate, loyalty, digital products, memberships, webinars, checkout, and platform-specific help. Use when the user has a sales or marketing question and isn't sure which skill to use, or wants a multi-skill sequence with a batch install command. Do NOT use to solve problems directly — this skill only routes.
39SKILL.mdUpdated Apr 24, 2026