referral-program

When the user wants to design, launch, or optimize a referral or affiliate program. Use when they mention 'referral program,' 'affiliate program,' 'word of mouth,' 'refer a friend,' 'incentive program,' 'customer referrals,' 'brand ambassador,' 'partner program,' 'referral link,' or 'growth through referrals.' Covers program mechanics, incentive design, and optimization — not just the idea of referrals but the actual system.

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

—

The risk profile of this skill

Quality

Content

78%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, actionable skill body that leverages real bundle files for progressive disclosure and packs in specific domain benchmarks. The main gaps are minor padding in the opening persona framing and the absence of explicit validation checkpoints and an inline script-usage example.

Suggestions

Trim the opening persona paragraph and restated truisms (e.g. "Timing is everything", "Remove every possible point of friction") to tighten conciseness.

Add a one-line inline usage example for scripts/referral_roi_calculator.py (expected inputs/outputs) so the sizing guidance is fully self-contained.

Insert an explicit validation/checkpoint step into the Mode 1 design workflow (e.g. confirm incentive sizing against LTV/CAC before finalizing the spec) to match the feedback-loop quality of Mode 2.

Dimension	Reasoning	Score
Conciseness	Mostly lean, table-driven reference content with specific benchmarks Claude would not already know, but the opening persona paragraph ("You are a growth engineer... programs that collect dust") and a few restated truisms ("Timing is everything", "Remove every possible point of friction") could be trimmed.	4 / 5
Actionability	Highly actionable guidance with concrete sizing rules ("≥10% of first month's value", "cap at 30% of first payment"), exact benchmark numbers, a tiered-reward example, and copy-paste checklists, but the referenced calculator script is invoked without an inline usage example, leaving a minor gap.	4 / 5
Workflow Clarity	Three numbered mode workflows give clear sequences and Mode 2 includes a measure-before-next-lever feedback loop, but the Mode 1 design workflow is a linear six-step sequence with no explicit validation checkpoints, keeping it below the 5 anchor.	4 / 5
Progressive Disclosure	Clear overview structure with well-signaled one-level-deep references to verified bundle files (references/measurement-framework.md, references/program-mechanics.md, scripts/referral_roi_calculator.py), with detail appropriately split out of the overview.	5 / 5
	Total	17 / 20 Passed

Description

95%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, third-person description that explicitly states both capability and trigger conditions with a rich set of natural synonyms. The only minor weakness is that the listed actions are high-level verbs rather than fully granular concrete operations.

Dimension	Reasoning	Score
Specificity	Lists several concrete actions — "design, launch, or optimize a referral or affiliate program" plus "Covers program mechanics, incentive design, and optimization" — but the verbs remain somewhat high-level rather than granular, so it sits below the comprehensive 5 anchor.	4 / 5
Completeness	Explicitly answers both what (design/launch/optimize referral and affiliate programs covering mechanics, incentive design, optimization) and when ("Use when they mention..." with concrete trigger phrases), matching the top anchor.	5 / 5
Trigger Term Quality	Comprehensive coverage of natural terms including synonyms and variations — "referral program," "affiliate program," "word of mouth," "refer a friend," "brand ambassador," "partner program," "referral link," "growth through referrals" — matching the best anchor.	5 / 5
Distinctiveness Conflict Risk	Clear niche (referral/affiliate program systems) with distinct triggers and a boundary clause ("not just the idea of referrals but the actual system"), giving minimal conflict risk with other skills.	5 / 5
	Total	19 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: alirezarezvani/claude-skills
Path: marketing-skill/skills/referral-program/SKILL.md
Commit: 19392f7

Reviewed: ~2 hours ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.