CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

66

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is referral-program in alirezarezvani/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

71%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.

The body is well-structured, concrete, and numbers-grounded, with clear three-mode workflows and effective use of tables over prose. Its main defect is structural: it points to two reference files and a ROI calculator script that are missing from the bundle, so progressive disclosure fails at the exact moment a user follows it, and the main file carries content that should live in those references.

Suggestions

Ship the referenced bundle files — create references/measurement-framework.md, references/program-mechanics.md, and scripts/referral_roi_calculator.py — or remove the references and the "Run scripts/referral_roi_calculator.py" instruction, since all three currently point to nonexistent paths.

Move the Affiliate Program Launch Checklist and the Reward Types table into the (existing) reference files to shorten SKILL.md toward an overview-plus-pointers shape.

Tighten the opening persona paragraph and other narrative flourishes ("programs that compound and programs that collect dust") to cut tokens without losing clarity.

DimensionReasoningScore

Conciseness

The body is dense and table-driven (Referral vs. Affiliate, Reward Types, Optimization Levers, Key Metrics) with no explanations of concepts Claude already knows, but minor padding remains — the persona preamble ("You know the difference between programs that compound and programs that collect dust") and a few narrative flourishes could be trimmed from the 275-line body.

4 / 5

Actionability

Concrete, numbers-grounded guidance throughout ("Reward should be ≥10% of first month's value", "cap at 30% of first payment", "Cookie window set (30 days minimum, 90 days for B2B)", named platforms Impact/ShareASale/Rewardful/PartnerStack, a worked tier example), but "Run `scripts/referral_roi_calculator.py`" references a script that does not exist in the bundle, leaving a small execution gap.

4 / 5

Workflow Clarity

All three modes give a clear numbered sequence, and advisory checkpoints are present ("Measure the impact before moving to the next lever", "10-affiliate pilot before scaling", "Confirm reward eligibility as soon as referral signs up"). Not 5 because the checkpoints are directional advice rather than explicit validate-fix-retry loops; not 3 because sequencing and checkpointing are clearly present and the domain is non-destructive, so no cap applies.

4 / 5

Progressive Disclosure

References are well-signaled and one level deep ("See [references/measurement-framework.md] for benchmarks by industry", "See [references/program-mechanics.md] for detailed program patterns"), but neither referenced file exists in the bundle — references/, scripts/, and assets/ directories are all absent — so the disclosure structure dead-ends. The ~275-line body also inlines content (affiliate launch checklist, reward-type tables) that the reference files were meant to carry.

3 / 5

Total

15

/

20

Passed

Description

91%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 description that clearly states what the skill covers and when to trigger it, backed by an unusually thorough list of natural trigger phrases. The only weakness is mild overlap risk from a few broad marketing terms and a capability list that stops one level short of the body's full scope.

DimensionReasoningScore

Specificity

The description names the domain and several concrete actions ("design, launch, or optimize a referral or affiliate program") plus coverage areas ("program mechanics, incentive design, and optimization"), with only minor gaps — it stops short of enumerating the distinct sub-capabilities (incentive sizing, affiliate toolkit, measurement framework) that the body actually covers.

4 / 5

Completeness

Explicitly answers both halves: what it does ("design, launch, or optimize a referral or affiliate program... Covers program mechanics, incentive design, and optimization") and when to use it ("Use when they mention [concrete trigger phrases]"), matching the top anchor's what+when pattern with concrete triggers.

5 / 5

Trigger Term Quality

Comprehensive natural trigger terms with synonyms: 'referral program,' 'affiliate program,' 'word of mouth,' 'refer a friend,' 'incentive program,' 'customer referrals,' 'brand ambassador,' 'partner program,' 'referral link,' and 'growth through referrals' — the phrases a user would actually say when they need this skill.

5 / 5

Distinctiveness Conflict Risk

The referral/affiliate niche is clear and mostly distinct, but broad trigger terms like 'incentive program,' 'partner program,' and 'word of mouth' carry minor overlap risk with general marketing or go-to-market skills — noticeable above the midpoint but not the fully clean niche of a 5.

4 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 2 missing

Warning

referenced_paths_exist

Referenced path issues: 5 missing

Warning

Total

14

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

.gemini/skills/referral-program/SKILL.md

Reviewed

Table of Contents

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.