Agent skill · data analytics · jeremylongshore
shopify-debug-bundle
Collect Shopify debug evidence including API versions, scopes, rate
Why this skill is useful
Adds a comprehensive bash script for collecting diagnostic information specific to Shopify, which the AI wouldn't reliably generate on its own.
What it needs
Requires curl, jq installed locally. Requires shopify account access. About 2k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Shopify Debug Bundle Overview Collect all diagnostic information needed for Shopify support tickets: API version compatibility, access scopes, rate limit state, recent errors, and connectivity checks. Prerequisites Shopify access token (shpatxxx) available curl and jq installed Store domain known (.myshopify.com) Instructions Step 1: Create and Run Debug Bundle The debug bundle script collects shop info, access scopes, supported API versions, GraphQL and REST rate limit state, environment details (Node/npm versions, SDK version, env vars), then packages everything into a tarball with tokens automatically redacted. See Debug Bundle Script for the complete bash script. Set these environment variables before running: Output shopify-debug-YYYYMMDD-HHMMSS.tar.gz containing: summary.txt — shop info, scopes, API versions, rate limits, environment All secrets automatically redacted Error Handling Diagnostic What It Reveals If It Fails ----------- ---------------- ------------- Shop info Store name, plan, timezone Token invalid or store unreachable Access scopes What your app can access Token expired or revoked API versions Which versions the store supports Network issue Rate limit state Current bucket fill level Token or network issue SDK version Whether SDK needs updating Package not installed Examples Sensitive Data Checklist ALWAYS REDACT before sharing: Access tokens (shpatxxx) API keys and secrets Customer PII (emails, names, addresses) Order details with customer data Safe to include: Store name and plan API version and scopes Error messages and X-Request-Id values Rate limit headers SDK/runtime versions Quick One-Liner Health Check Resources Shopify API Response Codes Shopify Partner Support Shopify Status Page
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/shopify-debug-bundle