referral-program

When the user wants to create, optimize, or analyze a referral program, affiliate program, or word-of-mouth strategy. Also use when the user mentions 'referral,' 'affiliate,' 'ambassador,' 'word of mouth,' 'viral loop,' 'refer a friend,' or 'partner program.' This skill covers program design, incentive structure, and growth optimization.

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Medium

Suggest reviewing before use

Quality

Content

67%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 instruction-only skill that uses tables, templates, and checklists effectively and appropriately delegates affiliate/examples detail to reference files. Its main weakness is redundancy between the context-gathering sections, which slightly inflates the token budget.

Suggestions

Merge 'Task-Specific Questions' into 'Before Starting' (or replace one with the other) — the two sections ask nearly the same LTV/CAC/tools/budget questions, creating avoidable duplication.

Trim the persona opener ('You are an expert in viral growth... Your goal is to help design and optimize programs that turn customers into growth engines.') to a single line or remove it; it restates the description without adding instruction value.

Consider moving the full email-sequence templates and the metrics reference tables into a reference file, keeping only the loop diagram and one example inline, to further sharpen the overview.

Dimension	Reasoning	Score
Conciseness	Mostly efficient through tables, checklists, and bullet points without over-explaining known concepts, but the 'Before Starting' and 'Task-Specific Questions' sections substantially overlap and the opener ('You are an expert...') adds mild fluff that could be trimmed.	3 / 5
Actionability	Provides concrete, usable guidance — a ranked share-mechanism list, a problems/fixes table, copy-paste-ready email templates with subject lines, specific metrics, and a phased launch checklist — with only minor gaps (e.g., incentive sizing is delegated rather than given inline).	4 / 5
Workflow Clarity	Sequences the work clearly (context-gathering → Step 1/2/3 design → optimization → measurement → phased launch checklist) with post-launch review checkpoints; appropriate for a non-destructive design task, though explicit validate-and-iterate loops are only implicit in the optimization section.	4 / 5
Progressive Disclosure	SKILL.md serves as an overview and delegates detail to two real, one-level-deep, well-signaled references (program-examples.md for examples/sizing, affiliate-programs.md for affiliate design); minor gaps in that some inline material (email sequences, metrics) could arguably be split out.	4 / 5
	Total	15 / 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, well-constructed description that clearly states capabilities and provides an explicit, keyword-rich 'use when' clause with natural synonyms. It is comprehensive and distinct, with only minor abstraction in the action verbs.

Dimension	Reasoning	Score
Specificity	Names the domain and several concrete actions ('create, optimize, or analyze a referral program, affiliate program, or word-of-mouth strategy' plus 'program design, incentive structure, and growth optimization'), but the actions are slightly more abstract than the 5-anchor's tangible operations, leaving minor coverage gaps.	4 / 5
Completeness	Explicitly answers both 'what' (design/optimize/analyze referral/affiliate/WOM programs, incentive structure, growth optimization) and 'when' ('When the user wants to... Also use when the user mentions...') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Comprehensive coverage of natural terms users would say, including synonyms and phrasings: 'referral,' 'affiliate,' 'ambassador,' 'word of mouth,' 'viral loop,' 'refer a friend,' and 'partner program.'	5 / 5
Distinctiveness Conflict Risk	Occupies a clear niche (referral/affiliate/word-of-mouth growth) with distinct trigger terms unlikely to fire for unrelated skills; minimal conflict risk.	5 / 5
	Total	19 / 20 Passed

Validation

87%

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 — 14 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning
relative_links	Relative link issues: 6 suspicious	Warning

	Total	14 / 16 Passed

Repository: freekmurze/dotfiles
Path: config/claude/skills/referral-program/SKILL.md
Commit: a7899fe

Reviewed: 3 days 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.