Shopify Admin Return Cost Attribution

Read-only: calculates the true cost of returns by reason and product — refund dollars, restocking impact, shipping cost lost, and COGS impact for items written off.

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-cost-attribution
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-cost-attribution ~/.claude/skills/shopify-admin-return-cost-attribution

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
Quantifies the full cost of returns over a window — not just the refunded amount. Combines refund totals, lost shipping revenue, COGS for non-restockable items (e.g., `DEFECTIVE`), and restocking labor into a per-reason and per-product return P&L. Read-only. Use to prioritize which reasons or product lines deserve operational fixes — better packaging, size guides, listing accuracy.

## Prerequisites
- `shopify store auth --store <domain> --scopes read_orders,read_returns,read_inventory`
- API scopes: `read_orders`, `read_returns`, `read_inventory`

## Parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| store | string | yes | — | Store domain (e.g., mystore.myshopify.com) |
| format | string | no | human | Output format: `human` or `json` |
| days_back | integer | no | 90 | Lookback window for returns |
| group_by | string | no | reason | Aggregation level: `reason`, `product`, `sku`, or `reason_x_product` |
| min_returns | integer | no | 3 | Minimum returns per group to include in summary |
| writeoff_reasons | array | no | `["DEFECTIVE"]` | Return reasons whose items are treated as non-restockable (full COGS write-off) |
| flat_restocking_cost | float | no | 5.00 | Average labor cost per return line item to model restocking workload |

## Safety
Read the full skill on GitHub

Details

Skill name
shopify-admin-return-cost-attribution
Path
skills/returns/shopify-admin-return-cost-attribution/SKILL.md
License
MIT
Repo updated
26 October 2026

FAQ

What does the Shopify Admin Return Cost Attribution skill do?

Read-only: calculates the true cost of returns by reason and product — refund dollars, restocking impact, shipping cost lost, and COGS impact for items written off.

How do I install the Shopify Admin Return Cost Attribution 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 Cost Attribution 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.