From shopify-admin-skills
Aggregates shipping revenue charged to customers vs. actual shipping line costs by carrier/method to identify subsidies or overcharges.
How this skill is triggered — by the user, by Claude, or both
Slash command
/shopify-admin-skills:shopify-admin-shipping-cost-analysisThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Compares the shipping amount charged to customers against the actual shipping cost recorded on orders, broken down by carrier and shipping method. Identifies where shipping is being subsidized (charged less than cost) or over-charged. Read-only — no mutations.
Compares the shipping amount charged to customers against the actual shipping cost recorded on orders, broken down by carrier and shipping method. Identifies where shipping is being subsidized (charged less than cost) or over-charged. Read-only — no mutations.
shopify store auth --store <domain> --scopes read_ordersread_orders| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| store | string | yes | — | Store domain (e.g., mystore.myshopify.com) |
| days_back | integer | no | 30 | Lookback window |
| format | string | no | human | Output format: human or json |
ℹ️ Read-only skill — no mutations are executed. Safe to run at any time.
OPERATION: orders — query
Inputs: query: "financial_status:paid created_at:>='<NOW - days_back days>'", first: 250, select shippingLines { title, discountedPriceSet, originalPriceSet, carrierIdentifier }, pagination cursor
Expected output: Orders with shipping line details; paginate until hasNextPage: false
For each shipping line: record carrier (from title or carrierIdentifier), charged amount (discountedPriceSet), and actual cost if available
Group by carrier/method; calculate total charged, total cost, net subsidy/overage
# orders:query — validated against api_version 2025-01
query ShippingCostAnalysis($query: String!, $after: String) {
orders(first: 250, after: $after, query: $query) {
edges {
node {
id
name
createdAt
totalShippingPriceSet {
shopMoney {
amount
currencyCode
}
}
shippingLines(first: 5) {
edges {
node {
id
title
carrierIdentifier
originalPriceSet {
shopMoney {
amount
currencyCode
}
}
discountedPriceSet {
shopMoney {
amount
currencyCode
}
}
}
}
}
}
}
pageInfo {
hasNextPage
endCursor
}
}
}
Claude MUST emit the following output at each stage. This is mandatory.
On start, emit:
╔══════════════════════════════════════════════╗
║ SKILL: Shipping Cost Analysis ║
║ 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>
On completion, emit:
For format: human (default):
══════════════════════════════════════════════
SHIPPING COST ANALYSIS (<days_back> days)
Orders analyzed: <n>
Total charged to customers: $<amount>
Free shipping orders: <n>
By Carrier/Method:
"Standard Shipping" Orders: <n> Charged: $<n> Avg: $<n>
"Express" Orders: <n> Charged: $<n> Avg: $<n>
Output: shipping_cost_<date>.csv
══════════════════════════════════════════════
For format: json, emit:
{
"skill": "shipping-cost-analysis",
"store": "<domain>",
"period_days": 30,
"orders_analyzed": 0,
"total_shipping_charged": 0,
"free_shipping_order_count": 0,
"currency": "USD",
"by_method": [],
"output_file": "shipping_cost_<date>.csv"
}
CSV file shipping_cost_<YYYY-MM-DD>.csv with columns:
order_name, shipping_method, carrier, charged_amount, original_price, discount_applied, currency
| Error | Cause | Recovery |
|---|---|---|
THROTTLED | API rate limit exceeded | Wait 2 seconds, retry up to 3 times |
| No shipping lines | Digital products or free shipping store | Report $0 shipping revenue |
| Carrier identifier missing | Custom or manual shipping methods | Use title as carrier name |
originalPriceSet vs discountedPriceSet difference represents shipping discounts applied to customers — useful for understanding total shipping subsidy cost.average-order-value-trends to evaluate whether free shipping thresholds are driving the intended AOV lift.npx claudepluginhub 40rty-ai/shopify-admin-skills --plugin shopify-admin-skillsCompares delivery times and shipping costs across carriers used in Shopify fulfillments, segmented by country or weight class. Informs carrier mix and contract decisions.
Manages Wix e-commerce shipping rules via REST APIs: query rates, retrieve details, create rates with costs, regions, logistics, and conditions like free shipping over subtotal. For store shipping configuration.
Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.