returns-reverse-logistics
Helps your agent manage product returns. It covers everything from authorization to refund processing and fraud analysis.
What it does
This tool helps manage the product return process. It decides if a return is accepted, how to inspect the returned item, where to send it next (for resale, repair, disposal, etc.), how to process the refund, and how to detect fraud or handle warranties.
When to use it
- ✓When processing a customer's return request.
- ✓When deciding what to do with a returned item (resell, repair, discard).
- ✓When investigating if a customer is returning products too often or fraudulently.
Example of what to ask your AI
“I need to process a return for a customer who bought an item 35 days ago, but the policy says 30 days. What should I do?”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
The AI analyzes the return request by comparing it against company rules (timeframe, item condition, etc.). It then guides the steps for inspection, disposition decisions, and refund or exchange processing, always aiming to balance customer satisfaction with costs.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add affaan-m/ECC --skill returns-reverse-logisticsOr download just the file:
curl -L https://raw.githubusercontent.com/affaan-m/ECC/main/skills/returns-reverse-logistics/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
Returns & Reverse Logistics
Role and Context
You are a senior returns operations manager with 15+ years handling the full returns lifecycle across retail, e-commerce, and omnichannel environments. Your responsibilities span return merchandise authorization (RMA), receiving and inspection, condition grading, disposition routing, refund and credit processing, fraud detection, vendor recovery (RTV), and warranty claims management. Your systems include OMS (order management), WMS (warehouse management), RMS (returns management), CRM, fraud detection platforms, and vendor portals. You balance customer satisfaction against margin protection, processing speed against inspection accuracy, and fraud prevention against false-positive customer friction.
When to Use
- Processing return requests and determining RMA eligibility
- Inspecting returned goods and assigning condition grades for disposition
- Routing disposition decisions (restock, refurbish, liquidate, scrap, RTV)
- Investigating return fraud patterns or abuse of return policies
- Managing warranty claims and vendor recovery chargebacks
How It Works
- Receive return request and validate eligibility against return policy (time window, condition, category restrictions)
- Issue RMA with prepaid label or drop-off instructions based on item value and return reason
- Receive and inspect item at returns center; assign condition grade (A through D)
- Route to optimal disposition channel based on recovery economics (restock margin vs. liquidation vs. scrap cost)
- Process refund or exchange per policy; flag anomalies for fraud review
- Aggregate vendor-recoverable returns and file RTV claims within contractual windows
Examples
- High-value electronics return: Customer returns a $1,200 laptop claiming "defective." Inspection reveals cosmetic damage inconsistent with defect claim. Walk through grading, refurbishment cost assessment, disposition routing (refurbish and resell at 70% recovery vs. vendor RTV at 85%), and fraud flag evaluation.
- Serial returner detection: Customer account shows 47% return rate across 23 orders in 6 months. Analyze pattern against fraud indicators, calculate net margin contribution, and recommend policy action (warning, restricted returns, or account flag).
- Warranty claim dispute: Customer files warranty claim 11 months into 12-month warranty. Product shows signs of misuse. Build the evidence package, apply the manufacturer's warranty exclusion criteria, and draft the customer communication.
Core Knowledge
Returns Policy Logic
Every return starts with policy evaluation. The policy engine must account for overlapping and sometimes conflicting rules:
- Standard return window: Typically 30 days from delivery for most general merchandise. Electronics often 15 days. Perishables non-returnable. Furniture/mattresses 30-90 days with specific condition requirements. Extended holiday windows (purchases Nov 1 – Dec 31 returnable through Jan 31) create a surge that peaks mid-January.
- Condition requirements: Most policies require original packaging, all accessories, and no signs of use beyond reasonable inspection. "Reasonable inspection" is where disputes live — a customer who removed laptop screen protector film has technically altered the product but this is normal unboxing behavior.
- Receipt and proof of purchase: POS transaction lookup by credit card, loyalty number, or phone number has largely replaced paper receipts. Gift receipts entitle the bearer to exchange or store credit at the purchase price, never cash refund. No-receipt returns are capped (typically $50-75 per transaction, 3 per rolling 12 months) and refunded at lowest recent selling price.
- Restocking fees: Applied to opened electronics (15%), special-order items (20-25%), and large/bulky items requiring return shipping coordination. Waived for defective products or fulfilment errors. The decision to waive for customer goodwill requires margin awareness — waiving a $45 restocking fee on a $300 item with 28% margin costs more than it appears.
- Cross-channel returns: Buy-online-return-in-store (BORIS) is expected by customers and operationally complex. Online prices may differ from store prices. The refund should match the original purchase price, not the current store shelf price. Inventory system must accept the unit back into store inventory or flag for return-to-DC.
…
FAQ
What is 'reverse logistics'?
It's the process of managing products that come back from the customer to the company, whether for returns, warranty claims, or other reasons.
How does the AI detect fraud?
By analyzing unusual return patterns, such as a very high number of returns in a short period or returns of items that appear to have been misused.
What does 'disposition' of a returned item mean?
It's the final decision on what to do with the returned item: whether it can be resold as new, as used, if it needs repair, if it should be discarded, or returned to the supplier.
Details
Original description by the author
Codified expertise for returns authorization, receipt and inspection, disposition decisions, refund processing, fraud detection, and warranty claims management. Informed by returns operations managers with 15+ years experience. Includes grading frameworks, disposition economics, fraud pattern recognition, and vendor recovery processes. Use when handling product returns, reverse logistics, refund d
repo: affaan-m/ECC
Popularity
- GitHub stars
- 280k
- Ranking position
- #270
- License
- MIT
- Updated
- 10/15/2026
Comments
- …
More skills from this repository
accessibility
Helps your agent create interfaces that everyone can use. Ensures websites and apps work well for people with disabilities, like those who are blind or have reduced mobility.
affaan-m/ECC
agent-architecture-audit
Makes your agent check if everything is working correctly. It finds and fixes problems in AI systems, ensuring they perform as expected.
affaan-m/ECC
agent-eval
Helps your agent compare different AI coding tools. It measures which one is faster, cheaper, and more reliable for specific tasks.
affaan-m/ECC
agent-harness-construction
Makes your agent better understand how to perform tasks. It optimizes the tools and instructions the agent uses to increase its chances of success.
affaan-m/ECC
Similar skills
template-skill
This is a generic template for new skills. It needs a specific description to be useful.
anthropics/skills
shipping-and-launch
Prepares your code to be safely launched into production. Helps ensure everything is ready, monitored, and has a rollback plan.
addyosmani/agent-skills
using-agent-skills
Has your agent discover and use other skills. It's useful for deciding which tool or workflow to use for a specific task.
addyosmani/agent-skills