Shopify REST → GraphQL Migration Surgeon

About this skill

Migrate your Shopify app off the legacy REST Admin API without breaking production. Shopify's REST Admin API is legacy — new apps must be GraphQL-first, and deprecation pressure on existing REST apps escalates every year. Shopify's free tools convert one call at a time. This skill migrates your whole app. WHAT IT DOES - Scans your entire codebase with a bundled read-only Python scanner: finds every REST call site across raw URLs, shopify-api-js / Remix REST clients, resource classes, Ruby ShopifyAPI usage, and Python resource classes. - Classifies every resource by risk and assigns it to a 5-phase cutover plan (foundations -> low-risk -> medium -> high-risk -> platform migrations). - Generates a polished, client-ready HTML Migration Readiness Report (prints to PDF) — the artifact your team approves or your agency bills against. - Executes the migration phase by phase, handling the six things that break naive migrations: numeric IDs -> GIDs, page_info pagination -> cursors/bulk operations, HTTP-status error handling -> 200-with-errors + userErrors, 429/Retry-After -> cost-point throttling, split/merged operation shapes (e.g. productDeleteMedia), and scope/response-shape verification. - Finds "collapse opportunities" — chained REST calls that become one GraphQL query. SAFETY & HONESTY - The scanner is read-only and makes zero network calls. - No code is modified until you approve the phase plan. - Unverified operation mappings are labeled as unverified; Asset/Checkout surfaces are reported honestly as platform-feature migrations, not call swaps. WHO IT'S FOR Developers and agencies maintaining Shopify public apps, custom apps, or integrations still on the REST Admin API. Includes: scanner script, six-conversions playbook, resource->GraphQL risk map, report spec, and a full sample Migration Readiness Report.