Shopify Admin Partial Refund Pattern Detector

Read-only: surfaces orders with multiple partial refunds or unusually high partial-refund-to-total ratios that may indicate fraud, chronic complaints, or process gaps.

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-partial-refund-pattern-detector
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/order-intelligence/shopify-admin-partial-refund-pattern-detector ~/.claude/skills/shopify-admin-partial-refund-pattern-detector

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
Scans recent orders, extracts every refund, and flags orders that have either (a) two or more partial refunds, or (b) a partial-refund-to-order-total ratio above a configurable threshold. These patterns frequently indicate friendly fraud (incremental claims), an unhappy repeat customer pattern, or a staff workflow gap (refunding piecemeal instead of issuing one full credit). Read-only — no mutations.

## Prerequisites
- Authenticated Shopify CLI session: `shopify store auth --store <domain> --scopes read_orders`
- API scopes: `read_orders`

## Parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| store | string | yes | — | Store domain (e.g., mystore.myshopify.com) |
| days_back | integer | no | 90 | Lookback window for orders to analyze |
| min_partials | integer | no | 2 | Minimum number of partial refunds to flag an order |
| ratio_threshold | float | no | 0.5 | Flag orders where total refunded / order total exceeds this ratio (still partial, i.e. below 1.0) |
| min_order_value | float | no | 25 | Skip low-value orders below this amount |
| format | string | no | human | Output format: `human` or `json` |

## Safety

> ℹ️ Read-only skill — no mutations are executed. Safe to run at any time. Flagged orders are advisory — confirm with refund notes and customer history before taking action against a customer account.

## Workflow Steps

1. **OPERATION:** `orders` — query
Read the full skill on GitHub

Details

Skill name
shopify-admin-partial-refund-pattern-detector
Path
skills/order-intelligence/shopify-admin-partial-refund-pattern-detector/SKILL.md
License
MIT
Repo updated
26 October 2026

FAQ

What does the Shopify Admin Partial Refund Pattern Detector skill do?

Read-only: surfaces orders with multiple partial refunds or unusually high partial-refund-to-total ratios that may indicate fraud, chronic complaints, or process gaps.

How do I install the Shopify Admin Partial Refund Pattern Detector 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 Partial Refund Pattern Detector 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.