From shopify-admin-skills
Audits Shopify discount catalog for expired, unused, or duplicate codes; optionally deletes them.
How this skill is triggered — by the user, by Claude, or both
Slash command
/shopify-admin-skills:shopify-admin-discount-hygiene-cleanupThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Audits the discount catalog for expired codes, codes with zero redemptions, and duplicate code prefixes. Discount sprawl accumulates over months of campaigns and makes the admin difficult to navigate. Optionally deletes flagged codes. Replaces manual discount cleanup and builds on the `discount-ab-analysis` skill with a write step.
Audits the discount catalog for expired codes, codes with zero redemptions, and duplicate code prefixes. Discount sprawl accumulates over months of campaigns and makes the admin difficult to navigate. Optionally deletes flagged codes. Replaces manual discount cleanup and builds on the discount-ab-analysis skill with a write step.
shopify store auth --store <domain> --scopes read_discounts,write_discountsread_discounts, write_discounts| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| store | string | yes | — | Store domain (e.g., mystore.myshopify.com) |
| flag_expired | bool | no | true | Flag/delete discounts past their end date |
| flag_zero_usage | bool | no | true | Flag/delete discounts with 0 redemptions older than N days |
| zero_usage_min_age_days | integer | no | 30 | Age threshold for zero-usage flags |
| dry_run | bool | no | true | Preview without executing mutations |
| format | string | no | human | Output format: human or json |
⚠️
discountCodeDeletepermanently removes discount codes. Deleted codes cannot be recovered. Customers who received a deleted code will find it invalid. Run withdry_run: trueto review the flagged list before committing. Always check that expired codes are not referenced in active email campaigns before deleting.
OPERATION: discountNodes — query
Inputs: first: 250, select discount { ... on DiscountCodeBasic { codes, usageLimit, asyncUsageCount, endsAt, status } }, pagination cursor
Expected output: All discount codes with usage and expiry data; paginate until hasNextPage: false
Flag discounts matching: flag_expired (status = EXPIRED) and/or flag_zero_usage (asyncUsageCount == 0 AND created > zero_usage_min_age_days ago)
OPERATION: discountCodeDelete — mutation
Inputs: id: <discount_node_id>
Expected output: deletedCodeDiscountId, userErrors
# discountNodes:query — validated against api_version 2025-01
query DiscountAudit($after: String) {
discountNodes(first: 250, after: $after) {
edges {
node {
id
discount {
... on DiscountCodeBasic {
title
status
createdAt
endsAt
asyncUsageCount
usageLimit
codes(first: 5) {
edges {
node {
id
code
}
}
}
}
... on DiscountCodeBxgy {
title
status
createdAt
endsAt
asyncUsageCount
usageLimit
}
... on DiscountCodeFreeShipping {
title
status
createdAt
endsAt
asyncUsageCount
usageLimit
}
}
}
}
pageInfo {
hasNextPage
endCursor
}
}
}
# discountCodeDelete:mutation — validated against api_version 2025-01
mutation DiscountCodeDelete($id: ID!) {
discountCodeDelete(id: $id) {
deletedCodeDiscountId
userErrors {
field
message
}
}
}
Claude MUST emit the following output at each stage. This is mandatory.
On start, emit:
╔══════════════════════════════════════════════╗
║ SKILL: Discount Hygiene Cleanup ║
║ Store: <store domain> ║
║ Started: <YYYY-MM-DD HH:MM UTC> ║
╚══════════════════════════════════════════════╝
After each step, emit:
[N/TOTAL] <QUERY|MUTATION> <OperationName>
→ Params: <brief summary of key inputs>
→ Result: <count or outcome>
If dry_run: true, prefix every mutation step with [DRY RUN] and do not execute it.
On completion, emit:
For format: human (default):
══════════════════════════════════════════════
OUTCOME SUMMARY
Discounts scanned: <n>
Expired: <n>
Zero usage (> <n> days): <n>
Total flagged: <n>
Deleted: <n>
Errors: <n>
Output: discount_cleanup_<date>.csv
══════════════════════════════════════════════
For format: json, emit:
{
"skill": "discount-hygiene-cleanup",
"store": "<domain>",
"started_at": "<ISO8601>",
"dry_run": true,
"outcome": {
"scanned": 0,
"flagged_expired": 0,
"flagged_zero_usage": 0,
"deleted": 0,
"errors": 0,
"output_file": "discount_cleanup_<date>.csv"
}
}
CSV file discount_cleanup_<YYYY-MM-DD>.csv with columns:
discount_id, title, status, created_at, ends_at, usage_count, usage_limit, flag_reason, action
| Error | Cause | Recovery |
|---|---|---|
THROTTLED | API rate limit exceeded | Wait 2 seconds, retry up to 3 times |
userErrors on delete | Discount already deleted or active order using it | Log error, skip, continue |
| No discounts flagged | Clean discount catalog | Exit with ✅ no cleanup needed |
flag_zero_usage age at 30+ days to avoid deleting codes from recently launched campaigns.npx claudepluginhub 40rty-ai/shopify-admin-skills --plugin shopify-admin-skillsBulk-creates unique discount codes for Shopify campaigns, giveaways, or partner distributions. Each code is a standalone DiscountCodeBasic with configurable value, usage limit, and validity window.
Manages Wix coupons and discounts via REST API: query active/expired/usage-based lists, create fixed-amount/percent-off types, detect conflicts, calculate margins.
Triages WooCommerce coupon performance by analyzing discount impact, revenue drivers, acquisition metrics, and effective costs using built-in analytics tools.