Shopify Admin Return Reason Analysis
Read-only: aggregates return reasons across orders to identify product quality or listing issues.
Install
/plugin marketplace add 40RTY-ai/shopify-admin-skillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add 40RTY-ai/shopify-admin-skills --skill shopify-admin-return-reason-analysisgit clone --depth 1 https://github.com/40RTY-ai/shopify-admin-skills.git /tmp/shopify-admin-skills
mkdir -p ~/.claude/skills
cp -r /tmp/shopify-admin-skills/skills/returns/shopify-admin-return-reason-analysis ~/.claude/skills/shopify-admin-return-reason-analysisPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
## Purpose
Queries all return requests within a date window and aggregates them by return reason code, product, and SKU. Surfaces which products have the highest return rates and which reasons (wrong size, damaged, not as described, etc.) are most common. Read-only — no mutations.
## Prerequisites
- Authenticated Shopify CLI session: `shopify store auth --store <domain> --scopes read_orders,read_returns`
- API scopes: `read_orders`, `read_returns`
## Parameters
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| store | string | yes | — | Store domain (e.g., mystore.myshopify.com) |
| days_back | integer | no | 30 | Lookback window for return requests |
| min_returns | integer | no | 3 | Minimum returns per product to include in output |
| format | string | no | human | Output format: `human` or `json` |
## Safety
> ℹ️ Read-only skill — no mutations are executed. Safe to run at any time.
## Workflow Steps
1. **OPERATION:** `returns` — query
**Inputs:** `query: "created_at:>='<NOW - days_back days>'"`, `first: 250`, pagination cursor
**Expected output:** Return objects with `returnLineItems { returnReason, refundableQuantity, fulfillmentLineItem { lineItem { product { title } variant { sku } } } }`; paginate until `hasNextPage: false`
2. Aggregate by: return reason → product → SKU; calculate return count and % of total returns per bucket
3. **OPERATION:** `orders` — query (for return rate context)Details
- Skill name
shopify-admin-return-reason-analysis- Repository
- 40RTY-ai/shopify-admin-skills
- Path
skills/returns/shopify-admin-return-reason-analysis/SKILL.md- License
- MIT
- Repo updated
- 26 October 2026
FAQ
What does the Shopify Admin Return Reason Analysis skill do?
Read-only: aggregates return reasons across orders to identify product quality or listing issues.
How do I install the Shopify Admin Return Reason Analysis skill?
Claude Code plugin: /plugin marketplace add 40RTY-ai/shopify-admin-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Shopify Admin Return Reason Analysis popular?
It lives in 40RTY-ai/shopify-admin-skills, which has 204 GitHub stars and 23 forks.
Related skills
Shopify Admin Abandoned Cart Recovery
20440RTY-ai/shopify-admin-skills
Query checkouts abandoned in the last N days, generate unique discount codes per customer, and tag them for re-engagement.
Shopify Admin Address Correction
20440RTY-ai/shopify-admin-skills
Update the shipping address on an unfulfilled order before it ships.
Shopify Admin Agentic Crawler Access
20440RTY-ai/shopify-admin-skills
Edit the theme's robots.txt.liquid to explicitly allow AI crawlers (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, OAI-SearchBot, Amazonbot) so AI assistants are permitted to read the catalog.
Shopify Admin Revenue By Location Report
20440RTY-ai/shopify-admin-skills
Read-only: breaks down revenue by fulfillment location for multi-warehouse P&L and location performance.
Shopify Admin Return Processing Sla
20440RTY-ai/shopify-admin-skills
Read-only: measures average time from return request to refund completion, surfacing SLA breaches.
Shopify Admin Rfm Customer Segmentation
20440RTY-ai/shopify-admin-skills
Read-only: scores every customer on Recency, Frequency, and Monetary value to segment them into actionable groups (Champions, Loyal, At-Risk, Lost).
Browse the most popular Claude skills, all marketing, sales & business skills, or write your own with the skills generator.