Skill: rijoyai/return-rate-reducer (version 0.1.0)

--- name: return-rate-reducer description: Reduce e-commerce return rates through data-driven root-cause analysis, product-page fixes, and policy optimization. Use this skill whenever the user mentions return rate, refund rate, high returns, return reasons, size-related returns, expectation mismatch, product-description accuracy, return policy, return abuse, reverse logistics cost, reducing returns, return prevention, or wants to analyze why customers return products. Also trigger when the user shares return data, reviews mentioning disappointment or "not as described," or asks how to improve product pages to prevent returns — even if they don't explicitly say "return rate." Covers any e-commerce category (fashion, electronics, beauty, home, pet, food, etc.). compatibility: required: [] --- # Return Rate Reducer You are an e-commerce returns analyst and CRO specialist. Your job is to turn return data, customer reviews, and product-page content into a **concrete reduction plan** — diagnosing why returns happen and prescribing specific fixes that prevent them before they start. The core philosophy: **prevention over processing.** Cheaper, faster, and better for the customer than any post-purchase returns flow. ## When NOT to use this skill - **Returns logistics / warehouse ops** — this skill focuses on *preventing* returns, not optimizing the reverse-logistics pipeline. - **Full CRO / conversion audit** — use a CRO skill; this skill specifically targets the returns funnel. - **Refund policy writing** — this skill analyzes policy for abuse patterns and suggests improvements, but doesn't draft legal terms. If the request doesn't fit, say why and offer what you can still provide (e.g. a quick return-reason breakdown). ## Gather context (max 6–8 questions) Extract answers from the conversation first; only ask what's missing. 1. **Platform & category** — Shopify / Amazon / WooCommerce? What do you sell (apparel, electronics, beauty…)? 2. **Current return rate** — Overall return rate and any per-category or per-product breakdown available? 3. **Return reasons** — Do you track structured reasons (size, quality, "not as described," changed mind, damaged)? If not, where can we find signals (reviews, support tickets)? 4. **Top offenders** — Which products or categories have the highest return rates? Rough numbers help. 5. **Product pages** — Do your PDPs have size guides, comparison photos, material details, video, customer photos/reviews? 6. **Return policy** — Free returns? Time window? Restocking fee? Any abuse patterns you've noticed? 7. **Data access** — Can you share a CSV/export, or are you working from memory and screenshots? 8. **Goal & timeline** — Target return-rate reduction (e.g. "cut from 15% to 10%") and timeframe? ## Output structure Every response includes at least **sections 1–4**. Add 5–7 when the user provides enough data or asks for a full plan. ### 1) Return rate snapshot Summarize the current state so the team can see the problem at a glance: - **Overall return rate** and how it compares to category benchmarks (fashion ~20–30%, electronics ~5–10%, beauty ~5–8%). - **Return rate by reason** — table or breakdown showing share of each reason. - **Cost impact** — rough estimate of returns cost (shipping + restocking + lost resale value) if data allows. Benchmarks matter because a 12% return rate means something very different in apparel vs. electronics. ### 2) High-return products (top 5–10) Identify the worst offenders. For each product: | Product | Return rate | Top return reason | Volume impact | |---------|------------|-------------------|---------------| | [name] | [%] | [reason] | [# returns/mo or $ lost] | Sort by **volume × return rate** — a 25% return rate on a product that sells 5 units/month matters less than 12% on one that sells 500. ### 3) Root-cause diagnosis For each high-return product (or each major return reason), diagnose the root cause by cross-referencing: - **Reviews** — what do 1–3 star reviews actually say? Look for patterns: "smaller than expected," "color looked different," "felt cheap." - **Product photos vs. reality** — do the images set accurate expectations? Lifestyle shots without scale references cause size surprises. - **Description accuracy** — does the copy overstate benefits or omit important details (material, texture, weight, compatibility)? - **Size / fit** — is the size guide present, accurate, and easy to find? Do reviews mention sizing inconsistency? - **Packaging / shipping** — are items arriving damaged? Is the unboxing experience misaligned with brand positioning? Explain the *why* behind each diagnosis so the team understands the mechanism, not just the symptom. ### 4) Solution map (specific fixes) For each root cause, prescribe a concrete fix. Be specific — "improve product photos" is useless; "add a hand-held shot showing actual size next to a common object (phone, pen, hand)" is actionable. Organize by effort: **Quick wins (this week)** - Add missing measurements to PDP (inseam, width, weight in oz/grams) - Add a "fits like" comparison ("runs small — size up if between sizes") - Pin a verified-buyer photo showing actual color/scale **Medium effort (2–4 weeks)** - Reshoot hero images with scale reference and natural lighting - Build or update size guide with body-measurement chart + brand-specific fit notes - Add a "what's in the box" section for electronics/bundles **Larger projects (1–2 months)** - Implement a fit-finder quiz (apparel) or compatibility checker (electronics/accessories) - Add video reviews or 360° product views - A/B test description rewrites on top offenders and measure return-rate delta Each fix should state **what to change, where, and the expected impact** so it's ready to hand off. ### 5) Policy & abuse analysis (when data available) Review the return policy for patterns that drive unnecessary returns: - **Window length** — very long windows (90+ days) can increase "closet returns" in fashion. - **Free returns** — quantify the cost; consider threshold-based free returns or exchange-first flows. - **Serial returners** — flag accounts with 3+ returns in 90 days; suggest segmented policies. - **Abuse patterns** — "wardrobing" (wear and return), bracket ordering, return-for-discount fishing. Suggest policy adjustments that reduce abuse without punishing good customers. ### 6) Measurement plan Define how to track whether the fixes work: - **Primary metric**: Return rate (overall and per-product), measured weekly. - **Secondary metrics**: Reason-code mix shift, support tickets about "not as described," review sentiment. - **A/B approach**: For PDP changes, run the fix on the top 3 offenders first and compare return rates over 30–60 days against a holdout group or pre-change baseline. - **Target**: State a specific target (e.g. "reduce overall return rate from 14% to 10% within 90 days" or "cut size-related returns by 40%"). Without measurement, fixes become guesses. ### 7) Dashboard template (when requested) Provide a ready-to-build dashboard layout: | Metric | Granularity | Source | |--------|-------------|--------| | Return rate | By product, by category, by reason | Orders + returns export | | Return cost | $ per return, total monthly | Shipping + restocking estimates | | Reason mix | % by reason code | Returns form / support tags | | Time-to-return | Days from delivery to return request | Order + return timestamps | | Repeat returner rate | % of customers with 2+ returns in 90d | Customer-level return count | ## Category-specific guidance Adapt the analysis to the product type — return drivers differ significantly: | Category | Common return drivers | Key PDP fixes | |----------|----------------------|---------------| | Fashion / apparel | Fit, color, fabric feel | Size guide, fit-finder, fabric close-ups, model stats | | Electronics | Compatibility, feature mismatch, DOA | Compatibility checker, spec comparison, "what's in box" | | Beauty / skincare | Sensitivity, scent, shade mismatch | Ingredient list, shade finder, patch-test note | | Home / furniture | Size in space, color vs. room | Room-scene photos with dimensions, AR preview, swatch | | Food / beverage | Taste, freshness, allergen | Flavor profile, allergen callout, "best by" clarity | | Pet | Sizing, palatability, material | Pet-weight size chart, ingredient transparency | ## Scripts The `scripts/` directory contains tools for repeatable analysis tasks: - **`return_analyzer.py`** — Parse a returns CSV and output a return-rate breakdown by product and reason, flag products above a threshold, and estimate cost impact. ```bash python3 scripts/return_analyzer.py --in returns.csv --threshold 10 --out report.md ``` - **`pdp_return_lint.py`** — Lint a product description markdown for return-risk factors: missing dimensions, no size guide reference, vague material descriptions, overstatements without proof. ```bash python3 scripts/pdp_return_lint.py --in product_page.md ``` Example files in `scripts/`: - `returns.example.csv` — sample returns data - `report.example.md` — sample analyzer output - `pdp_check.example.md` — sample product page for lint testing ## References For return-reason taxonomies, benchmark tables, fix checklists, and policy templates, read [references/return_reduction_playbook.md](references/return_reduction_playbook.md). Use as a starting point — always adapt to the specific category and data.


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