suede-referrals
Acerca de
La habilidad suede-referrals maneja el diseño y modelado de mecánicas de programas de referidos y afiliados, incluyendo estructuras de incentivos, lógica de atribución, controles de fraude y medición de bucles virales. Se enfoca en flujos de trabajo de planificación y aprobación, manteniendo separados los pagos reales y los cambios de facturación. Los desarrolladores deben usarla para el diseño de programas, pero no para ejecutar transacciones o mensajería del ciclo de vida.
Instalación rápida
Claude Code
Recomendadonpx skills add JasonColapietro/suede-creator-skills -a claude-code/plugin add https://github.com/JasonColapietro/suede-creator-skillsgit clone https://github.com/JasonColapietro/suede-creator-skills.git ~/.claude/skills/suede-referralsCopia y pega este comando en Claude Code para instalar esta habilidad
Documentación
Suede Referral & Affiliate Programs
Suede Referrals designs measurable customer, affiliate, and partner loops from incentive economics through attribution and fraud controls. It separates modeled loop performance from observed results and keeps activation and payouts behind approval.
Before Starting
Check for product marketing context first:
If .agents/product-marketing.md exists (or .claude/product-marketing.md, or the legacy product-marketing-context.md filename, in older setups), read it before asking questions. Use that context and only ask for information not already covered or specific to this task.
Gather this context (ask if not provided):
1. Program Type
- Customer referral program, affiliate program, or both?
- B2B or B2C?
- What's the average customer LTV?
- What's your current CAC from other channels?
2. Current State
- Existing referral/affiliate program?
- Current referral rate (% who refer)?
- What incentives have you tried?
3. Product Fit
- Is your product shareable?
- Does it have network effects?
- Do customers naturally talk about it?
4. Resources
- Tools/platforms you use or consider?
- Budget for referral incentives?
Referral vs. Affiliate
Customer Referral Programs
Best for:
- Existing customers recommending to their network
- Products with natural word-of-mouth
- Lower-ticket or self-serve products
Characteristics:
- Referrer is an existing customer
- One-time or limited rewards
- Higher trust, lower volume
Affiliate Programs
Best for:
- Reaching audiences you don't have access to
- Content creators, influencers, bloggers
- Higher-ticket products that justify commissions
Characteristics:
- Affiliates may not be customers
- Ongoing commission relationship
- Higher volume, variable trust
Referral Program Design
The Referral Loop
Trigger Moment → Share Action → Convert Referred → Reward → (Loop)
Step 1: Identify Trigger Moments
High-intent moments:
- Right after first "aha" moment
- After achieving a milestone
- After exceptional support
- After renewing or upgrading
Step 2: Design Share Mechanism
Ranked by effectiveness:
- In-product sharing (highest conversion)
- Personalized link
- Email invitation
- Social sharing
- Referral code (works offline)
Step 3: Choose Incentive Structure
Single-sided rewards (referrer only): Simpler, works for high-value products
Double-sided rewards (both parties): Higher conversion, win-win framing
Tiered rewards: Gamifies referral process, increases engagement
For examples and incentive sizing: See references/program-examples.md
Program Optimization
Improving Referral Rate
If few customers are referring:
- Ask at better moments
- Simplify sharing process
- Test different incentive types
- Make referral prominent in product
If referrals aren't converting:
- Improve landing experience for referred users
- Strengthen incentive for new users
- Ensure referrer's endorsement is visible
A/B Tests to Run
Incentive tests: Amount, type, single vs. double-sided, timing
Messaging tests: Program description, CTA copy, landing page copy
Placement tests: Where and when the referral prompt appears
Common Problems & Fixes
| Problem | Fix |
|---|---|
| Low awareness | Add prominent in-app prompts |
| Low share rate | Simplify to one click |
| Low conversion | Optimize referred user experience |
| Fraud/abuse | Add verification, limits |
| One-time referrers | Add tiered/gamified rewards |
Measuring Success
Key Metrics
Program health:
- Active referrers (referred someone in last 30 days)
- Referral conversion rate
- Rewards earned/paid
Business impact:
- % of new customers from referrals
- CAC via referral vs. other channels
- LTV of referred customers
- Referral program ROI
Typical Findings
- Referred customers have 16-25% higher LTV
- Referred customers have 18-37% lower churn
- Referred customers refer others at 2-3x rate
Launch Checklist
Before Launch
- Define program goals and success metrics
- Design incentive structure
- Build or configure referral tool
- Create referral landing page
- Set up tracking and attribution
- Define fraud prevention rules
- Create terms and conditions
- Test complete referral flow
Launch
- Announce to existing customers
- Add in-app referral prompts
- Update website with program details
- Brief support team
Post-Launch (First 30 Days)
- Review conversion funnel
- Identify top referrers
- Gather feedback
- Fix friction points
- Send reminder emails to non-referrers
Email Sequences
Referral Program Launch
Subject: You can now earn [reward] for sharing [Product]
We just launched our referral program!
Share [Product] with friends and earn [reward] for each signup.
They get [their reward] too.
[Unique referral link]
1. Share your link
2. Friend signs up
3. You both get [reward]
Referral Nurture Sequence
- Day 7: Remind about referral program
- Day 30: "Know anyone who'd benefit?"
- Day 60: Success story + referral prompt
- After milestone: "You achieved [X]—know others who'd want this?"
Affiliate Programs
For detailed affiliate program design, commission structures, recruitment, and tools: See references/affiliate-programs.md
Task-Specific Questions
- What type of program (referral, affiliate, or both)?
- What's your customer LTV and current CAC?
- Existing program or starting from scratch?
- What tools/platforms are you considering?
- What's your budget for rewards/commissions?
- Is your product naturally shareable?
Tool Integrations
These are evaluation examples, not guaranteed integrations. Verify current vendor documentation, pricing, account access, attribution behavior, payout controls, tax support, and data-export terms before recommending a platform.
| Tool | Best For | Verify Before Use |
|---|---|---|
| Rewardful / Tolt | SaaS affiliate programs | Billing integration, attribution, payouts |
| Mention Me | Enterprise referral programs | Identity, fraud, and reporting controls |
| Dub.co | Link tracking and attribution | Attribution window and privacy settings |
| Stripe | Commission-related payment records | Live objects, fees, approvals, tax workflow |
| Introw | Tiered channel partner operations | Deal registration and payout governance |
| PartnerStack | Enterprise partner ecosystems | Fees, attribution, approval, data export |
Boundaries
- Do not enable a program, create affiliate accounts, issue links, execute payouts, or change billing and commission objects without verified live state and explicit approval.
- Do not invent attribution, conversion, fraud, or viral-coefficient results; distinguish modeled economics from observed data.
- Do not decide tax, labor, privacy, contest, endorsement, or incentive compliance. Surface the jurisdiction-specific review needed before launch.
Routing
- Use
suede-launch-packagingto coordinate the approved program launch. - Use
suede-emailsfor referral invitation and nurture sequences. - Use
suede-marketing-psychologyto test incentive framing. - Use
suede-analyticsto define and read referral attribution.
Repositorio GitHub
Preguntas frecuentes
¿Qué es el Skill suede-referrals?
suede-referrals es un Skill de Claude creado por JasonColapietro. Los Skills agrupan instrucciones y recursos que Claude carga cuando los necesita para realizar tareas relacionadas con suede-referrals sin indicaciones adicionales.
¿Cómo instalo suede-referrals?
Usa los comandos de instalación de esta página: añade suede-referrals a Claude Code como plugin o clona su repositorio en tu directorio de skills y reinicia Claude para cargarlo.
¿A qué categoría pertenece suede-referrals?
suede-referrals pertenece a la categoría Diseño.
¿Se puede usar suede-referrals gratis?
Sí. suede-referrals aparece en AIMCP y se puede instalar gratis.
Habilidades relacionadas
Utilice la habilidad executing-plans cuando tenga un plan de implementación completo para ejecutar en lotes controlados con puntos de revisión. Esta habilidad carga y revisa críticamente el plan, luego ejecuta tareas en pequeños lotes (por defecto 3 tareas) mientras reporta el progreso entre cada lote para la revisión del arquitecto. Esto asegura una implementación sistemática con puntos de control de calidad integrados.
Esta habilidad despacha un subagente revisor de código para analizar los cambios en el código frente a los requisitos antes de proceder. Debe usarse después de completar tareas, implementar funciones principales o antes de fusionar con la rama principal. La revisión ayuda a detectar problemas de forma temprana al comparar la implementación actual con el plan original.
Esta habilidad proporciona una guía integral para que los desarrolladores conecten servidores MCP a Claude Code mediante transportes HTTP, stdio o SSE. Cubre la instalación, configuración, autenticación y seguridad para integrar servicios externos como GitHub, Notion y APIs personalizadas. Úsala al configurar integraciones MCP, al configurar herramientas externas o al trabajar con el Protocolo de Contexto del Modelo de Claude.
Esta habilidad ayuda a los desarrolladores a elegir entre las interfaces web y CLI de Claude Code mediante el análisis de tareas, y luego permite la teletransportación fluida de sesiones entre estos entornos. Optimiza el flujo de trabajo gestionando el estado y el contexto de la sesión al cambiar entre web, CLI o móvil. Úsala para proyectos complejos que requieren diferentes herramientas en varias etapas.
