dev-troubleshooting
Installation
SKILL.md
Shopify Dev Troubleshooting — Triage First, Fix Fast
A symptom-driven triage skill for Shopify app developers. When your dev loop hits a wall, start here. Each pain below is sourced from the most-reported Reddit, Shopify Developer Community (community.shopify.dev), Shopify Community (community.shopify.com), and GitHub Shopify/* issues as of 2026-05-15.
Use this skill first when:
shopify app devexits with cryptic errors- The browser shows "No AppBridge context provided", 401, 302 loops, or 404 on
/auth/login - GraphQL "works" but data is missing in production
- Webhooks fire twice, never, or your handler keeps timing out
- A Function deploys fail with
[wasm-validator error] - App Review SLA is blown and you don't know what to do
- A dev-store billing test charge silently fails
If the symptom matches a row in the Diagnostic Table, jump straight to that fix. If not, work through the Decision Tree at the bottom.