Agent skill · data analytics · jeremylongshore
shopify-advanced-troubleshooting
Debug complex Shopify API issues using cost analysis, request tracing,
Why this skill is useful
Provides specific debugging techniques and GraphQL commands for troubleshooting Shopify API issues that the AI wouldn't reliably generate on its own.
What it needs
Requires curl, jq installed locally. Requires shopify account access. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Shopify Advanced Troubleshooting Overview Deep debugging for complex Shopify API issues: cost analysis with debug headers, webhook delivery inspection, GraphQL query introspection, and systematic isolation of intermittent failures. Prerequisites Access to Shopify admin and Partner Dashboard Familiarity with GraphQL and HTTP debugging curl and jq available Instructions Step 1: GraphQL Cost Analysis When queries THROTTLE unexpectedly, use the cost debug header by adding Shopify-GraphQL-Cost-Debug: 1 to your request. The response extensions.cost reveals why a query is expensive. Key: requestedQueryCost is first multiplied through nested connections. 50 products 20 variants (1 + 5 metafields) = high cost even if actual data is small. Step 2: Trace a Specific Request Every Shopify response includes X-Request-Id. Capture it for support escalation: Step 3: Webhook Delivery Inspection Inspect webhook delivery status in the Partner Dashboard, or query subscription health via API. See Webhook Status Query for the complete query and common delivery failure patterns. Step 4: GraphQL Introspection for API Version Differences Use introspection queries to check if specific fields or mutations exist in your API version. Query type for field lists or schema for available mutations filtered by prefix. Step 5: Systematic Isolation Run a layer-by-layer diagnostic that tests DNS, TCP, TLS, HTTP, GraphQL, and rate limit state independently. See Layer-by-Layer Diagnostic for the complete shell script. Step 6: Debug Intermittent Failures Wrap Shopify calls in a debug logger that captures timing, cost, and error data for pattern analysis. See Debug Intermittent Failures for the complete TypeScript implementation. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/shopify-advanced-troubleshooting--257357