From shopify-admin-skills
Audits Shopify delivery profiles and zones via GraphQL to flag missing shipping rates, manual-only rates, or uncovered geographies, preventing checkout failures.
npx claudepluginhub 40rty-ai/shopify-admin-skills --plugin shopify-admin-skillsThis skill uses the workspace's default tool permissions.
Audits the shipping configuration for every delivery profile on the store. Surfaces (a) zones with zero shipping rates configured (causing checkout failures), (b) zones with only manual flat rates (no carrier-calculated rates, often a missed setup step), and (c) profiles with no zone coverage for known sales geographies. A misconfigured zone silently drops checkout conversions — this skill catc...
Manages Wix eCommerce shipping rates via REST APIs: query lists, retrieve details, create rules with costs, regions, logistics, and conditions. Includes tax config guidance.
Configures Saleor shipping zones, price/weight-based methods, custom apps, warehouse allocation, and click-and-collect via GraphQL mutations. Use for e-commerce delivery setup.
Aggregates Shopify orders to compare shipping revenue charged to customers vs. actual carrier costs, grouped by carrier and method. Identifies subsidies or overcharges.
Share bugs, ideas, or general feedback.
Audits the shipping configuration for every delivery profile on the store. Surfaces (a) zones with zero shipping rates configured (causing checkout failures), (b) zones with only manual flat rates (no carrier-calculated rates, often a missed setup step), and (c) profiles with no zone coverage for known sales geographies. A misconfigured zone silently drops checkout conversions — this skill catches it before customers do. Read-only — no mutations.
shopify store auth --store <domain> --scopes read_shippingread_shipping| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| store | string | yes | — | Store domain (e.g., mystore.myshopify.com) |
| profile_filter | string | no | — | Optional delivery profile name to scope the audit |
| flag_manual_only | bool | no | true | Flag zones that have only manual rates (no carrier-calculated rates) |
| flag_high_price | float | no | — | Optional: flag any rate above this price (likely typo or stale) |
| format | string | no | human | Output format: human or json |
ℹ️ Read-only skill — no mutations are executed. Safe to run at any time. The skill reads delivery configuration only; it does not change any shipping behavior.
OPERATION: deliveryProfiles — query
Inputs: first: 50, select profileLocationGroups, profileItems, name, default, pagination cursor
Expected output: All delivery profiles, including the default, with location groups and product associations; paginate until hasNextPage: false
For each profile, walk every profileLocationGroups[].locationGroupZones. For each zone, capture: zone name, country codes, method definitions (rates).
Flag zones with: zero methodDefinitions, OR only manual priceConditions-based rates (no carrier-calculated method when flag_manual_only: true), OR a method whose price.amount > flag_high_price if the threshold is set.
Aggregate findings per profile, then build a global summary of misconfigured zones across the store.
# deliveryProfiles:query — validated against api_version 2025-01
query DeliveryProfilesAudit($after: String) {
deliveryProfiles(first: 50, after: $after) {
edges {
node {
id
name
default
profileItems(first: 1) {
edges {
node {
id
}
}
}
profileLocationGroups {
locationGroup {
id
locations(first: 50) {
edges {
node {
id
name
address {
countryCode
}
}
}
}
}
locationGroupZones(first: 50) {
edges {
node {
zone {
id
name
countries {
code {
countryCode
}
provinces {
code
}
}
}
methodDefinitions(first: 50) {
edges {
node {
id
name
active
rateProvider {
__typename
... on DeliveryRateDefinition {
price {
amount
currencyCode
}
}
... on DeliveryParticipant {
carrierService {
id
name
}
fixedFee {
amount
currencyCode
}
percentageOfRateFee
}
}
}
}
}
}
}
}
}
}
}
pageInfo {
hasNextPage
endCursor
}
}
}
Claude MUST emit the following output at each stage. This is mandatory.
On start, emit:
╔══════════════════════════════════════════════╗
║ SKILL: Shipping Rate Audit ║
║ 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 RATE AUDIT
Profiles inspected: <n>
Zones inspected: <n>
Zones with no rates: <n>
Zones manual-only: <n>
Rates above threshold: <n>
Critical issues (zero-rate zones):
Profile: <name> Zone: <name> Countries: <list>
Output: shipping_rate_audit_<date>.csv
══════════════════════════════════════════════
For format: json, emit:
{
"skill": "shipping-rate-audit",
"store": "<domain>",
"profiles_inspected": 0,
"zones_inspected": 0,
"zones_no_rates": 0,
"zones_manual_only": 0,
"rates_above_threshold": 0,
"issues": [],
"output_file": "shipping_rate_audit_<date>.csv"
}
CSV file shipping_rate_audit_<YYYY-MM-DD>.csv with columns:
profile_name, zone_name, countries, rate_count, manual_rate_count, carrier_rate_count, min_rate, max_rate, currency, flag
| Error | Cause | Recovery |
|---|---|---|
THROTTLED | API rate limit exceeded | Wait 2 seconds, retry up to 3 times |
| Profile has no products | Empty profile | Note in output, do not flag as critical |
Zone has only DeliveryRateDefinition (no carrier) | Manual rates only | Flag if flag_manual_only: true |
| Country list is null on a zone | Rest-of-world catch-all zone | Treat as wildcard, do not flag for missing countries |
flag_manual_only: false if your store is intentionally flat-rate.customers:query filtered by country to estimate revenue at risk.