Shopify REST → GraphQL Migration Surgeon

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.