← Back to Skills Marketplace
mguozhen

Amazon Return Optimizer

by mguozhen · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
162
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install amazon-return-optimizer
Description
Amazon return rate analyzer and reduction agent. Identify why customers return your products, fix listing accuracy issues, improve packaging to reduce damage...
README (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

Category Average Return Rate High Alert
Electronics 8–15% >20%
Clothing / Apparel 20–40% >45%
Shoes 25–35% >40%
Jewelry 10–20% >25%
Toys 5–10% >15%
Home & Kitchen 5–12% >18%
Beauty / Health 5–10% >15%
Sports & Outdoors 5–10% >15%
Books 1–3% >5%
Food & Grocery 2–5% >8%

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

Return Reason Analysis Framework

Top Amazon Return Reasons & Fixes

Return Reason Root Cause Fix
"Item defective or doesn't work" Manufacturing defect Supplier QC, materials upgrade
"Inaccurate website description" Listing mismatch Rewrite bullets, update images
"Item smaller/larger than expected" Size not clear Add size comparison image, dimensions in title
"Wrong item sent" Pick & pack error Work with FBA, check SKU setup
"No longer needed" Impulse purchase Add urgency to listing, not fixable
"Item arrived damaged" Packaging failure Improve inner packaging, double-box
"Didn't like the quality" Expectation mismatch Honest listing, better photos
"Bought by mistake" Listing confusion Clearer title, compatibility section
"Doesn't fit" Size guide missing Add size chart, fit guide to listing
"Missing parts/accessories" Incomplete shipment QC 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

Issue Solution
Product shifting in box Add void fill (air pillows, paper)
Box crushing Double-wall corrugated, minimum 32 ECT
Glass/fragile items Bubble wrap + foam inserts, "Fragile" label
Electronics Anti-static bag + foam surround
Liquid products Sealed 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
Usage Guidance
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).
Capability Analysis
Type: OpenClaw Skill Name: amazon-return-optimizer Version: 1.0.0 The skill bundle is a purely informational guide and framework designed to help an AI agent assist Amazon sellers in reducing product return rates. It contains benchmarks, diagnostic frameworks, and checklists for listing accuracy and packaging, all of which are consistent with its stated purpose in SKILL.md. No executable code, malicious instructions, or data exfiltration attempts were found.
Capability Assessment
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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install amazon-return-optimizer
  3. After installation, invoke the skill by name or use /amazon-return-optimizer
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of Amazon Return Optimizer: - Analyze Amazon return rates and identify root causes for product returns. - Provides listing accuracy audit, packaging improvement checklists, and benchmarking against category averages. - Includes FBA removal order management and reimbursement claim guidance. - Offers actionable templates and frameworks for return reduction and recovery. - Supports multiple triggers: return report analysis, listing audit, packaging review, and refund optimization.
Metadata
Slug amazon-return-optimizer
Version 1.0.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is 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... It is an AI Agent Skill for Claude Code / OpenClaw, with 162 downloads so far.

How do I install Amazon Return Optimizer?

Run "/install amazon-return-optimizer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Amazon Return Optimizer free?

Yes, Amazon Return Optimizer is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Amazon Return Optimizer support?

Amazon Return Optimizer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Amazon Return Optimizer?

It is built and maintained by mguozhen (@mguozhen); the current version is v1.0.0.

💬 Comments