Amazon Return Optimizer

Amazon return rate analyzer and reduction agent. Identify why customers return your products, fix listing accuracy issues, improve packaging to reduce damage...

MIT-0 · Free to use, modify, and redistribute. No attribution required.
0 · 46 · 0 current installs · 0 all-time installs
MIT-0
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Benign
high confidence
Purpose & Capability
Name/description (Amazon return analysis and reduction) align with the content of SKILL.md (benchmarks, audits, packaging guidance, reimbursement workflow). The skill requests no credentials or system access, which is proportional for a guidance/diagnostic tool.
Instruction Scope
SKILL.md is an instruction-only checklist and command-format interface that asks the user to supply return metrics and listing/packaging details. It does not instruct the agent to read system files, fetch data from Seller Central, or transmit data externally. One minor note: allowed-tools lists Bash, which would permit shell execution if the agent uses that tool — but the document contains no shell commands or instructions to run on the host. Review runtime policy for whether the agent will be allowed to execute Bash before providing sensitive files.
Install Mechanism
No install spec and no code files are included (instruction-only). Nothing will be downloaded or written to disk by the skill itself.
Credentials
The skill requests no environment variables, credentials, or config paths. That is proportionate for a purely advisory tool that relies on user-provided data.
Persistence & Privilege
Skill is not marked always:true and does not request persistent system changes. It is user-invocable and can be invoked autonomously by the agent (the platform default), which is expected for skills.
Assessment
This skill is a text-based advisor and appears internally consistent, but take these precautions before using it: do not paste or upload Seller Central credentials, API keys, or full account reports containing PII; only provide the minimal return metrics and redacted examples needed for analysis. Confirm whether your agent runtime will permit Bash execution — if so, avoid granting the agent file access or running commands that could leak data. If you need automated reconciliation with Seller Central or FBA, prefer skills that explicitly declare required credentials and have a known, trusted source (review the linked GitHub repo and author).

Like a lobster shell, security has layers — review code before you run it.

Current versionv1.0.0
Download zip
latestvk972w3eaddz7ctw9k4tb6q1z9h83ab00

License

MIT-0
Free to use, modify, and redistribute. No attribution required.

SKILL.md

Amazon Return Rate Optimizer

High return rates kill your margins and can get your listing suppressed. Diagnose why customers return your product, fix the root causes, and recover lost revenue from FBA reimbursements.

Commands

return analyze [data]           # analyze return reasons and patterns
return audit [product]          # listing accuracy audit to reduce returns
return benchmark [category]     # return rate benchmarks for your category
return reimbursement            # FBA reimbursement claim guide
return packaging                # packaging improvement checklist
return response [reason]        # how to address specific return reason
return removal                  # FBA removal order strategy
return report                   # generate return reduction action plan

What Data to Provide

  • Return rate % — from Seller Central Voice of Customer or FBA Returns report
  • Return reasons — paste the return reason breakdown
  • Product category — for benchmark comparison
  • Current listing — title, bullets, images description
  • Packaging details — how product is packaged for shipment

Return Rate Benchmarks by Category

CategoryAverage Return RateHigh Alert
Electronics8–15%>20%
Clothing / Apparel20–40%>45%
Shoes25–35%>40%
Jewelry10–20%>25%
Toys5–10%>15%
Home & Kitchen5–12%>18%
Beauty / Health5–10%>15%
Sports & Outdoors5–10%>15%
Books1–3%>5%
Food & Grocery2–5%>8%

Amazon suppression risk: Return rate >15% above category average may trigger review

Return Reason Analysis Framework

Top Amazon Return Reasons & Fixes

Return ReasonRoot CauseFix
"Item defective or doesn't work"Manufacturing defectSupplier QC, materials upgrade
"Inaccurate website description"Listing mismatchRewrite bullets, update images
"Item smaller/larger than expected"Size not clearAdd size comparison image, dimensions in title
"Wrong item sent"Pick & pack errorWork with FBA, check SKU setup
"No longer needed"Impulse purchaseAdd urgency to listing, not fixable
"Item arrived damaged"Packaging failureImprove inner packaging, double-box
"Didn't like the quality"Expectation mismatchHonest listing, better photos
"Bought by mistake"Listing confusionClearer title, compatibility section
"Doesn't fit"Size guide missingAdd size chart, fit guide to listing
"Missing parts/accessories"Incomplete shipmentQC check on packing line

Prioritization Matrix

High Return Rate × Fixable = ACT NOW
High Return Rate × Not Fixable = Manage/Accept
Low Return Rate × Fixable = Nice to Have
Low Return Rate × Not Fixable = Ignore

Listing Accuracy Audit

Run this checklist to reduce expectation-gap returns:

Dimensions & Size

  • Exact dimensions in title or first bullet (not just in description)
  • Size comparison image (next to common object or hand)
  • Weight listed if relevant to customer decision
  • Package dimensions vs. product dimensions clearly distinguished

Materials & Quality

  • Material composition stated (100% cotton, not just "soft fabric")
  • Color accuracy: photo matches real product (calibrated display)
  • Texture/finish described accurately (glossy vs. matte, rough vs. smooth)
  • Fragrance/scent honestly described

Compatibility

  • Compatible models/sizes explicitly listed (for accessories)
  • Incompatible items listed ("Does NOT fit iPhone 15 Pro Max")
  • Power requirements, voltage, plug type (for electronics)
  • Age appropriateness (for toys, children's products)

What's in the Box

  • Complete list of included items in listing
  • What's NOT included (batteries, tools, etc.)
  • Flat lay image showing all components

Packaging Improvement Guide

Transit Damage Prevention

IssueSolution
Product shifting in boxAdd void fill (air pillows, paper)
Box crushingDouble-wall corrugated, minimum 32 ECT
Glass/fragile itemsBubble wrap + foam inserts, "Fragile" label
ElectronicsAnti-static bag + foam surround
Liquid productsSealed inner bag + absorbent pad

Amazon Drop Test Standard: Box should survive 3-foot drop on each face, edge, and corner

FBA Packaging Requirements

  • Products must be in sealed poly bag or box (no exposed products)
  • Barcodes scannable through packaging
  • Sets/bundles bagged together with "Sold as Set" label
  • Adult products in opaque packaging

FBA Reimbursement Claims

Amazon owes you money when:

  • Units lost in FBA warehouse
  • Units damaged by Amazon (not customer)
  • Customer returned item but Amazon didn't restock or reimburse
  • Overcharged FBA fees (wrong size tier)

Reimbursement Process

  1. Lost inventory: Check Inventory Reconciliation Report → file case if discrepancy
  2. Damaged by Amazon: Check FBA Customer Returns report → units marked "Damaged:Amazon" → file claim
  3. Customer return not received: Wait 45 days after return initiated → file claim if not processed
  4. Fee overcharge: Check FBA Fee Preview → measure product → file dispute if wrong tier

Time limits: Most claims must be filed within 18 months of incident

Tools: Sellerboard, Getida, GETIDA (recovery services that work on % of recovered amount)

Return Reduction Action Plan Template

Week 1: Audit
- Download return reason report (90 days)
- Identify top 3 return reasons
- Score each: fixable in listing vs. product vs. packaging

Week 2: Listing Fixes
- Update listing based on accuracy audit
- Add size comparison image
- Rewrite any misleading bullets

Week 3: Packaging Fix
- Order improved packaging materials
- Update FBA prep instructions

Week 4: Monitor
- Compare return rate to 30 days prior
- File any pending reimbursement claims
- Repeat monthly

Output Format

  1. Return Rate Diagnosis — which reasons are causing most returns
  2. Priority Fix List — top 3 changes ranked by impact
  3. Listing Accuracy Checklist — specific items to update
  4. Packaging Recommendations — if damage is a factor
  5. Reimbursement Opportunity — estimate of recoverable Amazon errors
  6. 30-Day Action Plan — week-by-week improvement roadmap

Files

1 total
Select a file
Select a file to preview.

Comments

Loading comments…