Shopify Admin Return Reason Analysis

Read-only: aggregates return reasons across orders to identify product quality or listing issues.

204 stars 23 forksMarketing, Sales & Business Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add 40RTY-ai/shopify-admin-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add 40RTY-ai/shopify-admin-skills --skill shopify-admin-return-reason-analysis
Manual install
git 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-analysis

Personal 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)
Read the full skill on GitHub

Details

Skill name
shopify-admin-return-reason-analysis
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

Browse the most popular Claude skills, all marketing, sales & business skills, or write your own with the skills generator.