CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

referral-program

You are an expert in viral growth and referral marketing with access to referral program data and third-party tools. Your goal is to help design and optimize programs that turn customers into growth engines.

Quality

59%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills/skills/referral-program/SKILL.md

The canonical home for this skill is referral-program in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

56%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 a comprehensive, genuinely actionable reference for referral/affiliate program design with strong formulas, benchmarks, and templates, but it is padded with knowledge Claude already has and redundant sections. Its monolithic structure inlines template libraries and tool comparisons that belong in one-level-deep reference files.

Suggestions

Cut or compress sections Claude already knows: the referral-vs-affiliate characteristics lists, the Dropbox/Uber/Morning Brew/Notion case studies, and the duplicate 'Questions to Ask' section (merge into 'Before Starting').

Move email templates, the outreach template, and the Tools & Platforms listings into references/ files (e.g. EMAIL_TEMPLATES.md, TOOLS.md) linked from the body, keeping SKILL.md as an overview.

Delete the vacuous 'When to Use' closing line and the repeated persona paragraph at the top of the body — the frontmatter description already carries this.

DimensionReasoningScore

Conciseness

The ~600-line body repeats the frontmatter persona verbatim, re-explains widely known material (what referral vs. affiliate programs are, the Dropbox and Uber case studies), duplicates 'Before Starting' questions in a later 'Questions to Ask' section, and ends with filler ('This skill is applicable to execute the workflow or actions described in the overview'). This matches 'noticeably verbose; several unnecessary explanations or padded sections' rather than the mostly-efficient anchor 3.

2 / 5

Actionability

For an instruction-only skill, the guidance is mostly concrete and executable: the incentive-sizing formula with a worked example ('($1,200 × 0.70) - $200 = $640'), K-factor math, benchmark ranges, commission and cookie-duration tables, copy-paste outreach and email templates, and named tools. It is not a 5 because some optimization advice stays abstract ('Shorten the path to value', 'Make the referral prominent in product').

4 / 5

Workflow Clarity

A clear sequence runs from context gathering through program-type selection, design Steps 1-3, a phased launch checklist (Before/Launch/Post-Launch), and measurement/optimization. Not a 5 because there are no explicit validation checkpoints or feedback loops (e.g., when to re-check K-factor after changes), though no destructive/batch operations exist that would impose a cap.

4 / 5

Progressive Disclosure

The single ~600-line file is well-sectioned with headers and tables, but content that clearly belongs in separate reference files — email templates, tool/platform comparisons, example program case studies — is fully inlined, and no references exist at all. This matches 'some structure but... content that should be separate is inline' rather than anchor 2, which requires minimal structure.

3 / 5

Total

13

/

20

Passed

Description

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

The description establishes a clear domain niche but fails on two guideline requirements: it uses second-person voice and provides no 'Use when...' trigger clause. Keyword coverage omits 'affiliate' entirely despite it being a major part of the skill's content, and phrases like 'turn customers into growth engines' are fluffy over-claims rather than capabilities.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks about referral programs, affiliate programs, referral incentives, or word-of-mouth growth strategies.'

Rewrite in third person, e.g. 'Designs and optimizes customer referral and affiliate programs: incentive sizing, share mechanics, K-factor modeling, fraud prevention, and platform selection.'

Include affiliate-related keywords ('affiliate program', 'commission', 'affiliate recruitment') since roughly half the skill body covers affiliate programs.

DimensionReasoningScore

Specificity

Names the domain ('viral growth and referral marketing') with 1-2 actions ('help design and optimize programs'), matching the anchor-3 example, but the description is written in second person ('You are an expert...'), which the guidelines penalize by reducing specificity by 1. Phrases like 'access to referral program data and third-party tools' and 'turn customers into growth engines' add no concrete capability.

2 / 5

Completeness

Has a moderately clear 'what' ('help design and optimize programs that turn customers into growth engines') but no 'Use when...' clause or any trigger guidance, which caps completeness at 3 per the judging guidelines. Not a 2 because the 'what' is more than vague — it names the domain and the actions.

3 / 5

Trigger Term Quality

Contains natural terms users would say ('referral marketing', 'referral program', 'viral growth'), but misses common variations — notably 'affiliate' (half the skill's subject matter), plus 'word of mouth', 'referral links', and 'growth loops'. This matches 'some relevant keywords but missing common variations or synonyms', not the level above which requires good coverage.

3 / 5

Distinctiveness Conflict Risk

'Referral marketing' is a recognizable niche, but the broader framing ('viral growth', 'growth engines') creates overlap risk with general growth/marketing skills. It is somewhat specific yet could still trigger for adjacent marketing questions, matching anchor 3 rather than anchor 4's 'minor overlap risk with closely related skills'.

3 / 5

Total

11

/

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

skill_md_line_count

SKILL.md is long (609 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/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.