Files
claude-skills-reference/marketing-skill/referral-program/references/measurement-framework.md
Alireza Rezvani 52321c86bc feat: Marketing Division expansion — 7 → 42 skills (#266)
* feat: Skill Authoring Standard + Marketing Expansion plans

SKILL-AUTHORING-STANDARD.md — the DNA of every skill in this repo:
10 universal patterns codified from C-Suite innovations + Corey Haines' marketingskills patterns:

1. Context-First: check domain context, ask only for gaps
2. Practitioner Voice: expert persona, goal-oriented, not textbook
3. Multi-Mode Workflows: build from scratch / optimize existing / situation-specific
4. Related Skills Navigation: when to use, when NOT to, bidirectional
5. Reference Separation: SKILL.md lean (≤10KB), refs deep
6. Proactive Triggers: surface issues without being asked
7. Output Artifacts: request → specific deliverable mapping
8. Quality Loop: self-verify, confidence tagging
9. Communication Standard: bottom line first, structured output
10. Python Tools: stdlib-only, CLI-first, JSON output, sample data

Marketing expansion plans for 40-skill marketing division build.

* feat: marketing foundation — context + ops router + authoring standard

marketing-context/: Foundation skill every marketing skill reads first
  - SKILL.md: 3 modes (auto-draft, guided interview, update)
  - templates/marketing-context-template.md: 14 sections covering
    product, audience, personas, pain points, competitive landscape,
    differentiation, objections, switching dynamics, customer language
    (verbatim), brand voice, style guide, proof points, SEO context, goals
  - scripts/context_validator.py: Scores completeness 0-100, section-by-section

marketing-ops/: Central router for 40-skill marketing ecosystem
  - Full routing matrix: 7 pods + cross-domain routing to 6 skills in
    business-growth, product-team, engineering-team, c-level-advisor
  - Campaign orchestration sequences (launch, content, CRO sprint)
  - Quality gate matching C-Suite standard
  - scripts/campaign_tracker.py: Campaign status tracking with progress,
    overdue detection, pod coverage, blocker identification

SKILL-AUTHORING-STANDARD.md: Universal DNA for all skills
  - 10 patterns: context-first, practitioner voice, multi-mode workflows,
    related skills navigation, reference separation, proactive triggers,
    output artifacts, quality loop, communication standard, python tools
  - Quality checklist for skill completion verification
  - Domain context file mapping for all 5 domains

* feat: import 20 workspace marketing skills + standard sections

Imported 20 marketing skills from OpenClaw workspace into repo:

Content Pod (5):
  content-strategy, copywriting, copy-editing, social-content, marketing-ideas

SEO Pod (2):
  seo-audit (+ references enriched by subagent), programmatic-seo (+ refs)

CRO Pod (5):
  page-cro, form-cro, signup-flow-cro, onboarding-cro, popup-cro, paywall-upgrade-cro

Channels Pod (2):
  email-sequence, paid-ads

Growth + Intel + GTM (5):
  ab-test-setup, competitor-alternatives, marketing-psychology, launch-strategy, brand-guidelines

All 29 skills now have standard sections per SKILL-AUTHORING-STANDARD.md:
   Proactive Triggers (4-5 per skill)
   Output Artifacts table
   Communication standard reference
   Related Skills with WHEN/NOT disambiguation

Subagents enriched 8 skills with additional reference docs:
  seo-audit, programmatic-seo, page-cro, form-cro,
  onboarding-cro, popup-cro, paywall-upgrade-cro, email-sequence

43 files, 10,566 lines added.

* feat: build 13 new marketing skills + social-media-manager upgrade

All skills are 100% original work — inspired by industry best practices,
written from scratch in our own voice following SKILL-AUTHORING-STANDARD.md.

NEW Content Pod (2):
  content-production — full research→draft→optimize pipeline, content_scorer.py
  content-humanizer — AI pattern detection + voice injection, humanizer_scorer.py

NEW SEO Pod (3):
  ai-seo — AI search optimization (AEO/GEO/LLMO), entirely new category
  schema-markup — JSON-LD structured data, schema_validator.py
  site-architecture — URL structure + internal linking, sitemap_analyzer.py

NEW Channels Pod (2):
  cold-email — B2B outreach (distinct from email-sequence lifecycle)
  ad-creative — bulk ad generation + platform specs, ad_copy_validator.py

NEW Growth Pod (3):
  churn-prevention — cancel flows + save offers + dunning, churn_impact_calculator.py
  referral-program — referral + affiliate programs
  free-tool-strategy — engineering as marketing

NEW Intelligence Pod (1):
  analytics-tracking — GA4/GTM setup + event taxonomy, tracking_plan_generator.py

NEW Sales Pod (1):
  pricing-strategy — pricing, packaging, monetization

UPGRADED:
  social-media-analyzer → social-media-manager (strategy, calendar, community)

Totals: 42 skills, 27 Python scripts, 60 reference docs, 163 files, 43,265 lines

* feat: update index, marketplace, README for 42 marketing skills

- skills-index.json: 89 → 124 skills (42 marketing entries)
- marketplace.json: marketing-skills v2.0.0 (42 skills, 27 tools)
- README.md: badge 134 → 169, marketing row updated
- prompt-engineer-toolkit: added YAML frontmatter
- Removed build logs from repo
- Parity check: 42/42 passed (YAML + Related + Proactive + Output + Communication)

* fix: merge content-creator into content-production, split marketing-psychology

Quality audit fixes:

1. content-creator → DEPRECATED redirect
   - Scripts (brand_voice_analyzer.py, seo_optimizer.py) moved to content-production
   - SKILL.md replaced with redirect to content-production + content-strategy
   - Eliminates duplicate routing confusion

2. marketing-psychology → 24KB split to 6.8KB + reference
   - 70+ mental models moved to references/mental-models-catalog.md (397 lines)
   - SKILL.md now lean: categories overview, most-used models, quick reference
   - Saves ~4,300 tokens per invocation

* feat: add plugin configs, Codex/OpenClaw compatibility, ClawHub packaging

- marketing-skill/SKILL.md: ClawHub-compatible root with Quick Start for Claude Code, Codex CLI, OpenClaw
- marketing-skill/CLAUDE.md: Agent instructions (routing, context, anti-patterns)
- marketing-skill/.codex/instructions.md: Codex CLI skill routing
- .claude-plugin/marketplace.json: deduplicated, marketing-skills v2.0.0
- .codex/skills-index.json: content-creator marked deprecated, psychology updated
- Total: 42 skills, 27 Python tools, 60 references, 18 plugins

* feat: add 16 Python tools to knowledge-only skills

Enriched 12 previously tool-less skills with practical Python scripts:
- seo-audit/seo_checker.py — HTML on-page SEO analysis (0-100)
- copywriting/headline_scorer.py — headline quality scoring (0-100)
- copy-editing/readability_scorer.py — Flesch + passive + filler detection
- content-strategy/topic_cluster_mapper.py — keyword clustering
- page-cro/conversion_audit.py — HTML CRO signal analysis (0-100)
- paid-ads/roas_calculator.py — ROAS/CPA/CPL calculator
- email-sequence/sequence_analyzer.py — email sequence scoring (0-100)
- form-cro/form_field_analyzer.py — form field CRO audit (0-100)
- onboarding-cro/activation_funnel_analyzer.py — funnel drop-off analysis
- programmatic-seo/url_pattern_generator.py — URL pattern planning
- ab-test-setup/sample_size_calculator.py — statistical sample sizing
- signup-flow-cro/funnel_drop_analyzer.py — signup funnel analysis
- launch-strategy/launch_readiness_scorer.py — launch checklist scoring
- competitor-alternatives/comparison_matrix_builder.py — feature comparison
- social-media-manager/social_calendar_generator.py — content calendar
- readability_scorer.py — fixed demo mode for non-TTY execution

All 43/43 scripts pass execution. All stdlib-only, zero pip installs.
Total: 42 skills, 43 Python tools, 60+ reference docs.

* feat: add 3 more Python tools + improve 6 existing scripts

New tools from build agent:
- email-sequence/scripts/sequence_analyzer.py — email sequence scoring (91/100 demo)
- paid-ads/scripts/roas_calculator.py — ROAS/CPA/CPL/break-even calculator
- competitor-alternatives/scripts/comparison_matrix_builder.py — feature matrix

Improved scripts (better demo modes, fuller analysis):
- seo_checker.py, headline_scorer.py, readability_scorer.py,
  conversion_audit.py, topic_cluster_mapper.py, launch_readiness_scorer.py

Total: 42 skills, 47 Python tools, all passing.

* fix: remove duplicate scripts from deprecated content-creator

Scripts already live in content-production/scripts/. The content-creator
directory is now a pure redirect (SKILL.md only + legacy assets/refs).

* fix: scope VirusTotal scan to executable files only

Skip scanning .md, .py, .json, .yml — they're plain text files
that VirusTotal can't meaningfully analyze. This prevents 429 rate
limit errors on PRs with many text file changes (like 42 marketing skills).

Scan still covers: .js, .ts, .sh, .mjs, .cjs, .exe, .dll, .so, .bin, .wasm

---------

Co-authored-by: Leo <leo@openclaw.ai>
2026-03-06 03:56:16 +01:00

7.8 KiB
Raw Blame History

Measurement Framework — Referral Program Metrics, Benchmarks, and Optimization Playbook

The metrics that tell you if your referral program is working, what's broken, and what to fix first.


The Core Metric Stack

Track these weekly. Everything else is secondary.

Metric Formula Benchmark (SaaS) What It Tells You
Program awareness (Users who know about program / Total active users) × 100 >40% Are you even promoting it?
Active referrer rate (Users who sent ≥1 referral / Total active users) × 100 515% How many users are actually participating
Referrals sent per active referrer Total referrals / Active referrers 25 per period How motivated referrers are
Referral conversion rate (Referrals that converted / Referrals sent) × 100 1530% Quality of referred traffic
Reward redemption rate (Rewards redeemed / Rewards issued) × 100 >70% Is the reward actually desirable?
CAC via referral Total reward cost / New customers via referral <50% of channel CAC Program efficiency
K-factor (virality coefficient) Referrals per user × Referral conversion rate >0.5 for meaningful growth Is it self-sustaining?

Benchmarks by Stage and Model

Early-Stage SaaS (<$1M ARR)

Metric Expected Strong
Active referrer rate 25% >8%
Referral conversion rate 1020% >25%
CAC via referral vs. paid 3050% of paid CAC <25% of paid CAC

Growth-Stage SaaS ($1M$10M ARR)

Metric Expected Strong
Active referrer rate 510% >12%
Referral contribution to new signups 1020% >25%
Referral contribution to revenue 515% >20%

Consumer / Prosumer Products

Metric Expected Strong
Active referrer rate 820% >25%
Referral conversion rate 2040% >50% (with double-sided reward)
K-factor 0.30.7 >1.0 (true viral loop)

B2B Mid-Market (ACV $10k+)

Metric Expected Strong
Active referrer rate 38% >10%
Referral conversion rate 2040% (warm intros convert higher) >50%
Average deal size via referral vs. standard Similar 2040% higher (trust shortens negotiation)

Diagnosing the Broken Stage

Diagnosis Framework

Is referral rate low?
  └── Is awareness low? → Promote the program
  └── Is trigger placement wrong? → Move to better moment
  └── Is reward insufficient? → Test higher reward
  └── Is share flow too complex? → Simplify

Is referral conversion low?
  └── Is the landing page cold? → Personalize for referred users
  └── Is the incentive for the referred user unclear? → Make it above the fold
  └── Is signup friction high? → Reduce required fields

Is reward redemption low?
  └── Is reward notification delayed? → Send immediately on qualifying event
  └── Is reward type wrong? → Test cash vs. credit vs. feature unlock
  └── Is the redemption process complex? → Auto-apply credits, remove steps

The Optimization Playbook

Work in this order. Don't try to fix everything at once.

Phase 1: Foundation (Month 1)

Goal: Get to baseline awareness and share rate.

  1. Audit whether users know the program exists
  2. Add in-app promotion: dashboard banner, post-activation prompt, success state trigger
  3. Add referral program to the weekly/monthly activation email
  4. Ensure share flow works on mobile

Success gate: Program awareness >30%, Active referrer rate >3%

Phase 2: Trigger Optimization (Month 2)

Goal: Ask at the right moment, not just any moment.

  1. Map all current trigger points
  2. Move or add trigger to first aha moment (define aha moment first)
  3. A/B test: trigger after aha vs. trigger after 7-day retention
  4. Add NPS-linked trigger: score of 9-10 → immediate referral ask

Success gate: Active referrer rate increases by 30% over Phase 1

Phase 3: Incentive Tuning (Month 3)

Goal: Right reward, right timing, right delivery.

  1. Survey churned referrers — why did they stop?
  2. Test single-sided vs. double-sided if not already tested
  3. Test reward type: credit vs. cash vs. feature unlock
  4. Add reward status widget to dashboard: "You've earned $X. [View details]"
  5. Reduce reward payout delay — reward immediately on qualifying event, not month-end

Success gate: Reward redemption rate >70%, CAC via referral <40% of paid CAC

Phase 4: Conversion of Referred Users (Month 4)

Goal: Referred users should convert at 2× organic rate.

  1. Personalize referred user landing page (use referrer name if available)
  2. Highlight referred user's incentive above the fold — don't bury it
  3. A/B test: direct to product vs. direct to dedicated referral landing page
  4. Add "referred by" onboarding track: faster to aha, lower time to first value

Success gate: Referred user conversion rate 20%+ (vs. organic baseline)

Phase 5: Scale and Gamification (Month 5+)

Goal: Turn your top 5% of referrers into a real advocacy channel.

  1. Identify top referrers — reach out personally
  2. Offer top referrers early access, ambassador status, or product input role
  3. Launch tiered reward structure
  4. Quarterly referral challenges: "Top 10 referrers this quarter win X"

CAC via Referral — Full Calculation

CAC via referral = (Reward cost per referral × Successful referrals) + Program overhead costs
                   ───────────────────────────────────────────────────────────────────────────
                              New customers acquired via referral

Where:
- Reward cost per referral = referrer reward + referred user reward
- Program overhead = platform cost + engineering time + support time (amortized)
- Successful referrals = referrals that converted to paying customer

Example:

  • 200 referrals sent → 40 conversions (20% conversion rate)
  • Referrer reward: $30 per successful referral
  • Referred user reward: $20 (discount on first month)
  • Platform cost: $100/mo, engineering: $500/mo (amortized) → $600/mo overhead
  • Program overhead per conversion: $600 / 40 = $15

CAC via referral = ($30 + $20) × 40 + $600 / 40 = $65 per customer

Compare to paid CAC, and you know if the program is worth it.

Use scripts/referral_roi_calculator.py to model this for your numbers.


Affiliate-Specific Metrics

Metric Formula Benchmark
Active affiliate rate Active affiliates / Enrolled affiliates 2040%
Revenue per active affiliate Total affiliate revenue / Active affiliates Varies by niche
Affiliate-driven CAC Commission paid / New customers via affiliate Should be <standard CAC
Top affiliate concentration Revenue from top 20% of affiliates Normal if 80%+ of revenue from top 20%
Average cookie-to-conversion time Days from click to first payment Benchmark against your sales cycle

Warning sign: If >80% of affiliate revenue is from 12 partners, you have concentration risk. One partner leaving could tank the channel overnight. Diversify proactively.


Reporting Template

Weekly referral program summary:

REFERRAL PROGRAM — Week of [DATE]

Active referrers: X (↑/↓ vs. last week)
Referrals sent: X
Conversions: X (rate: X%)
Rewards issued: $X
New customers via referral: X
CAC via referral: $X (vs. $X paid CAC)

TOP THIS WEEK:
- [Name/segment] sent 12 referrals, 4 converted
- [Trigger optimization test] is showing +18% referrer rate

ISSUES:
- [What's broken and the plan to fix it]

NEXT ACTION:
- [One thing we're doing this week to improve the program]