Agent skill · operations · jeremylongshore
shopify-incident-runbook
Execute Shopify incident response with triage using Shopify status page,
Why this skill is useful
Provides specific diagnostic commands and workflows for handling Shopify API incidents that 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 Incident Runbook Overview Rapid incident response for Shopify API outages, authentication failures, and rate limit emergencies. Distinguish between Shopify-side issues and your app's integration issues. Prerequisites Access to Shopify admin and status page Application logs and metrics Communication channels (Slack, PagerDuty) Instructions Step 1: Quick Triage (First 5 Minutes) Run the triage script to check Shopify status, API connectivity, REST rate limits, and GraphQL throttle state in one pass. See Triage Script for the complete diagnostic script. Step 2: Decision Tree Step 3: Immediate Actions by Error Type Diagnostic commands and remediation for 401 (token expired), 429 (rate limited), and 5xx (Shopify internal errors). Always capture X-Request-Id headers for Shopify support. See Error Type Actions for complete commands per error type. Step 4: Communication Templates Internal (Slack): External (Merchant-facing): Output Triage completed within 5 minutes Root cause identified (Shopify vs. integration) Immediate mitigation applied Stakeholders notified Error Handling Scenario Response Time Escalation ---------- -------------- ------------ Shopify API fully down Monitor status page Nothing to fix on our side Auth token revoked < 15 min Trigger re-auth, notify merchant Rate limit exhaustion < 30 min Reduce query frequency, optimize costs Webhook delivery failures < 1 hour Check endpoint health, review HMAC Data sync stalled < 4 hours Run manual sync after resolution Examples One-Liner Health Check Post-Incident Checklist [ ] Timeline documented with UTC timestamps [ ] Root cause identified [ ] X-Request-Id values collected (for Shopify support) [ ] Customer impact assessed [ ] Prevention action items created [ ] Monitoring/alerting gaps identified Resources Shopify Status Page Shopify Partner Support Shopify Community Forums
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/shopify-incident-runbook--ed9b19