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,' 'partner program,' 'referral incentive,' 'how to get referrals,' 'customers referring customers,' or 'affiliate payout.' Use this whenever someone wants existing users or partners to bring in new customers. For launch-specific virality, see launch-strategy.
79
73%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/referral-program/SKILL.mdQuality
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong description with excellent trigger term coverage and clear completeness, explicitly answering both what the skill does and when to use it. The cross-reference to launch-strategy is a nice touch for reducing conflicts. The main weakness is that the 'what' portion could be more specific about concrete actions and deliverables beyond the general 'create, optimize, or analyze.'
Suggestions
Add more specific concrete actions to the 'what' portion, e.g., 'design reward structures, calculate affiliate payouts, draft referral email templates, map viral loop mechanics' to improve specificity.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (referral/affiliate programs) and mentions actions like 'create, optimize, or analyze,' but doesn't list specific concrete deliverables or outputs (e.g., 'design reward tiers, calculate payout structures, draft referral emails'). | 2 / 3 |
Completeness | Clearly answers both 'what' (create, optimize, or analyze referral/affiliate/word-of-mouth strategies) and 'when' (explicit 'Use when' clause with trigger terms, plus a clarifying boundary with the launch-strategy skill). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms including 'referral,' 'affiliate,' 'ambassador,' 'word of mouth,' 'viral loop,' 'refer a friend,' 'partner program,' 'referral incentive,' 'how to get referrals,' 'customers referring customers,' and 'affiliate payout.' These are terms users would naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | The description carves out a clear niche around referral and affiliate programs, and explicitly differentiates from a related skill ('For launch-specific virality, see launch-strategy'), reducing conflict risk significantly. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
57%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured strategic skill that serves as a solid overview for referral and affiliate program design, with good progressive disclosure to external references. Its main weaknesses are verbosity in explaining concepts Claude already understands (referral vs affiliate distinctions, general characteristics) and a lack of truly concrete, executable guidance—most advice remains at the strategic advisory level rather than providing specific implementation steps or code.
Suggestions
Trim the 'Referral vs. Affiliate' section significantly—Claude understands these concepts; focus only on decision criteria for choosing between them.
Add more concrete, actionable outputs: e.g., a specific referral program brief template, a sample tracking spreadsheet schema, or a concrete incentive calculation formula rather than general advice like 'test different incentive types.'
Add validation checkpoints to the launch checklist workflow, such as 'Test complete referral flow end-to-end and verify attribution tracking before announcing to customers.'
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably well-organized but includes some unnecessary explanatory content that Claude already knows (e.g., explaining what referral vs affiliate programs are, typical characteristics). The 'Referral vs. Affiliate' section and some of the context-gathering questions add bulk without adding unique instructional value. The email template examples and statistics ('16-25% higher LTV') are useful but the overall document could be tightened. | 2 / 3 |
Actionability | The skill provides structured checklists, a problem/fix table, and email templates which are somewhat actionable. However, it lacks concrete executable code, specific implementation steps, or copy-paste ready configurations. Much of the guidance remains at a strategic/advisory level ('simplify sharing process,' 'test different incentive types') rather than providing specific, concrete instructions Claude can directly execute. | 2 / 3 |
Workflow Clarity | The launch checklist provides a clear sequence of steps, and the referral loop (Trigger → Share → Convert → Reward → Loop) gives a good conceptual framework. However, there are no validation checkpoints or feedback loops for error recovery. The optimization section lists what to do but doesn't sequence it into a clear diagnostic workflow with decision points. | 2 / 3 |
Progressive Disclosure | The skill effectively uses progressive disclosure with clear references to external files: program examples in references/program-examples.md, affiliate details in references/affiliate-programs.md, and tool-specific guides linked in the tools table. References are one level deep and clearly signaled. The main document serves as a well-organized overview with appropriate depth. | 3 / 3 |
Total | 9 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
1bcff9f
Table of Contents
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.