Content
71%Weight 40%Scale 1-5Reviews 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.
| Dimension | Reasoning | Score |
|---|---|---|
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 |