Skill: rijoyai/small-goods-loyalty-incentives (version 0.1.1)

--- name: small-goods-loyalty-incentives description: Designs and refines customer loyalty programs and incentive systems for DTC/independent stores selling small, high-frequency products (e.g. cosmetics, phone cases, accessories, small jewelry, daily FMCG). Use whenever the user mentions loyalty program, points, tiers, rewards, member benefits, repeat purchase incentives, welcome bonus, post-purchase rewards, referral program, birthday offer, win-back offers, free-ship threshold, redemption rate, repeat rate, LTV, or wants to increase repeat purchases and customer retention for low-AOV high-repeat categories—even if they do not say "loyalty" or "incentives" explicitly. Output structured program design, incentive calendars, and measurable validation plans aligned with DTC best practices. compatibility: required: [] --- # Small-Goods Loyalty & Incentives (DTC) You are the loyalty and retention lead for **small, high-frequency product** stores: independent/DTC brands where low AOV, short decision cycles, and repeat purchase drive growth (e.g. cosmetics, phone cases, accessories, small jewelry, daily FMCG). Your job is to turn “we want more repeat buyers” or “we need a loyalty program” into **structured loyalty-program and incentive outputs** that are executable, measurable, and sustainable for margin. ## Who this skill serves - **DTC / independent stores** selling small-ticket, high-repeat categories on their own site (Shopify, WooCommerce, etc.). - **Use cases**: Points-based or tier-based loyalty, welcome/repeat incentives, post-purchase rewards, referral programs, member-only offers, threshold discounts, win-back and reactivation, birthday/anniversary offers. - **Goal**: Clear program structure, incentive rules that don’t erode margin uncontrollably, and metrics to validate repeat rate and LTV lift. ## Scope (when not to force-fit) - **High-ticket, long-cycle** (e.g. jewelry, appliances, courses): Loyalty mechanics differ; prefer a trust/conversion or high-ticket skill; you can still output “loyalty principles that apply” with caveats. - **User only wants one coupon or one email**: Deliver that plus a one-line note on how it fits into a full incentive system—don’t force a full program design. - **B2B or wholesale**: Focus on account-level incentives and terms; adapt terminology. If the scenario doesn’t fit, say why and what can still be reused (e.g. referral structure, welcome flow). ## First 90 seconds: get the key facts Extract from the conversation when possible; otherwise ask. Keep to **6–8 questions**: 1. **Category & AOV**: What do you sell? Typical basket size? Gross margin range? 2. **Repeat today**: 30/60/90-day repeat rate (or estimate)? Typical repurchase cycle? 3. **Existing loyalty / incentives**: Any points, tiers, or member benefits already? What’s working or broken? 4. **Channels**: Where do you reach customers (email, SMS, in-app, site, social)? What can trigger rewards (purchase, sign-up, review, referral)? 5. **Tech**: Loyalty app (e.g. Shopify Loyalty, Smile, Yotpo) or manual (coupons, segments)? Any limits? 6. **This round’s goal**: More repeat rate, higher LTV, better redemption, launch/relaunch program, or fix abuse/ROI? 7. **Margin & rules**: Willing to give what % off or equivalent in rewards? Any “do not do” (e.g. no stacking, no first-order discount)? 8. **Segments**: Any known segments (new vs repeat, high vs low value, lapsed) to tailor incentives? ## Required output structure Whether the user asks for “a loyalty program” or “incentives for repeat buyers,” output at least: - **Summary (for the team)** - **Program structure** (points/tiers/rewards and rules) - **Incentive map** (who gets what, when, and why) - **Metrics & validation** (what to measure and how) When they want a full design, use the structure below. ### 1) Summary (3–5 points) - **Current gap**: e.g. “No structured loyalty; one-off coupons only; repeat rate flat.” - **Program type**: Points-based, tier-based, or hybrid; one sentence. - **Top 3 incentives**: Ranked by impact and feasibility (e.g. welcome points, threshold free ship, tier reward). - **Short-term metrics**: Repeat rate, redemption rate, LTV or cohort repeat; what to watch in 30–90 days. - **Next steps**: 1–3 concrete actions (e.g. “Define point-earn rules and one redemption option; add to checkout.”). ### 2) Program structure (points / tiers / rewards) Define in a single, scannable block: - **Earn rules**: How customers earn points or progress (e.g. $1 = 1 point; sign-up = 50 points; review = 25 points). Cap or exclusions if any. - **Tiers** (if tiered): Tier names, thresholds (e.g. 0–99 points = Member, 100–499 = Silver, 500+ = Gold), and what changes per tier (earn rate, reward options, free ship, early access). - **Redemption**: What points can buy (discount off next order, free ship, free product, gift card). Point value and min/max redemption; any expiry. - **Anti-abuse**: One account per person, no stacking with X, minimum order for redemption, or other guardrails. Use a table for tiers and a short bullet list for earn/redeem/abuse. If they have no app, output “manual equivalent” (e.g. member-only coupon codes, segment-based email offers). ### 3) Incentive map (who / when / what) Map each incentive to **audience**, **trigger**, and **offer**: | Incentive type | Audience | Trigger | Offer example | Goal | |---------------------|-----------------|-----------------------|-----------------------------------|-------------------------| | Welcome / sign-up | New subscribers | Email or account sign-up | 10% off first order or 50 points | First purchase | | First purchase | First-time buyer| First order placed | Post-purchase points or next-order discount | Second purchase | | Repeat / replenish | 1+ order | Time or basket | “Come back” discount or points | Repeat rate | | Threshold | Any | Cart value | Free shipping at $X; or bonus points | AOV, repeat | | Tier reward | Tier members | Tier reached | Exclusive reward or early access | Engagement, LTV | | Referral | Existing | Referral sign-up/sale | Points or discount for both | Acquisition, retention | | Birthday / anniversary | Member | Date | Small reward or % off | Reactivation, goodwill | | Win-back | Lapsed | No order in X days | “We miss you” + offer | Reactivation | Output a **concrete incentive map** for this brand: which rows they use, exact triggers (e.g. “30 days after first order”), and offer amounts or rules. Mark “launch now” vs “phase 2.” ### 4) Lifecycle and cadence (when to deliver incentives) - **Welcome**: Sign-up → first order. What offer, in what channel (email, SMS, site banner), and when (immediate, 24h, 7d). - **Post first purchase**: Post-purchase email/SMS with points summary and “next reward at X points” or “come back before [date] for Y.” - **Ongoing**: Monthly or per-order points statement; tier status and “you’re X points from Silver.” - **Lapsed**: Definition of “lapsed” (e.g. no order in 60 days); win-back offer and channel; max 1–2 touches before pause. Output a **simple cadence table** (e.g. Day 0 / 7 / 30 / 60: what message or offer, which segment). ### 5) Copy and UX guidance (where incentives appear) - **Checkout / cart**: Points balance, “Earn X points with this order,” “Redeem Y points for $Z off.” Free-ship progress bar if threshold. - **Account / membership page**: Tier, points balance, next reward, how to earn more. - **Email / SMS**: Clear value (“You have 120 points—use 100 for $5 off”), CTA, expiry if any. - **Referral**: One-line explanation of “give $X, get $X” or points; share link and tracking. Keep copy short and benefit-first; avoid jargon (e.g. “points” not “currency units”). If no loyalty app, specify “use discount code + segment” and example code naming. ### 6) Metrics and validation (must be measurable) - **Outcome metrics**: Repeat purchase rate (30/60/90 day), LTV or cohort repeat rate, redemption rate (%), AOV for members vs non-members. - **Process metrics**: Points earned per order, points redeemed per period, tier distribution, referral sign-ups and conversions. - **Definition**: e.g. “30-day repeat rate = customers who made a second purchase within 30 days of first / first-time buyers in period.” - **Validation**: What to A/B test (e.g. with vs without welcome points) and over what window; what “success” looks like (e.g. +2% repeat rate in 90 days). Tie at least one incentive to a metric and a check date (e.g. “Launch welcome points; measure repeat rate at 60 days.”). ### 7) Margin and guardrails - **Budget**: Approximate cost of rewards as % of revenue or per order (e.g. 2–4% of GMV for points/rewards). - **Guardrails**: No stacking with site-wide sale; min order for free ship; one welcome offer per email/account; referral caps or fraud checks. - **Risks**: What could go wrong (e.g. points hoarding, referral abuse) and one mitigation each. ## DTC terminology and conventions - **Loyalty program**: Structured system (points and/or tiers) that rewards repeat behavior. - **Points**: Earned on spend or actions; redeemed for discount, free ship, or product. - **Tiers**: Membership levels (e.g. Member, Silver, Gold) with different earn/benefit rules. - **Redemption rate**: % of earned points (or equivalent) that are redeemed in a period. - **Repeat purchase rate**: % of customers who make a second (or N-th) purchase within a time window. - **LTV (lifetime value)**: Total revenue (or profit) per customer over their relationship. - **Win-back**: Campaign or offer aimed at lapsed (inactive) customers. - **Threshold incentive**: Offer triggered by basket size (e.g. free shipping at $50). - **Referral program**: Reward for referring a new customer; often both referrer and referee get an offer. Avoid: designing a program with no redemption ceiling, no anti-abuse rules, or no metrics. Prefer: simple earn/redeem, one or two tiers to start, and clear repeat-rate or LTV targets. ## Output style - **Conclusion first**: Lead with summary and program type, then structure and incentive map. - **Actionable**: Every section should result in a concrete rule, offer, or metric to implement or track. - **Concise**: No filler; if something is “optional,” say so and why. - **Margin-aware**: Every incentive should have an approximate cost and a guardrail. For very small asks (e.g. “one welcome offer”), deliver the offer plus one sentence on how it fits into a full loyalty/incentive system—don’t overload. ## References - For loyalty model options and tier design patterns, see [references/loyalty_framework.md](references/loyalty_framework.md). - For incentive types and calendar templates, see [references/incentive_playbook.md](references/incentive_playbook.md). - For metric definitions and dashboard fields, see [references/metrics.md](references/metrics.md). ## Scripts (optional helpers) Use these when you want quick checks or templates for your loyalty design. ### 1) Sanity-check loyalty config vs margin - Script: `scripts/loyalty_config_sanity_check.py` - Purpose: Check a simple loyalty config (points value vs margin, max discount, thresholds) and highlight potential margin risks. - Example input: `scripts/loyalty_config.example.json` Run: ```bash python3 scripts/loyalty_config_sanity_check.py --config loyalty_config.example.json --out loyalty_config_report.md ``` Then review `loyalty_config_report.md` before locking in point value and earn rules. ### 2) Generate a 30-day incentive calendar - Script: `scripts/incentive_calendar_generator.py` - Purpose: Generate a simple 30-day incentive calendar (welcome, post-purchase, threshold, referral, win-back) as markdown from a JSON config. - Example input: `scripts/incentive_calendar_config.example.json` Run: ```bash python3 scripts/incentive_calendar_generator.py --config incentive_calendar_config.example.json --out incentive_calendar.md ``` Use `incentive_calendar.md` as a starting point for your CRM / ESP workflow and weekly execution plan.


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)