Agent skill · software engineering · jeremylongshore
shopify-migration-deep-dive
Migrate e-commerce data to Shopify using bulk operations, product imports,
Why this skill is useful
Adds executable scripts for bulk product imports and migration validation that aren't in public docs.
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 Migration Deep Dive Overview Migrate product catalogs, customers, and orders to Shopify using the GraphQL Admin API bulk mutations, CSV imports, and incremental migration patterns. Prerequisites Source platform data exported (CSV, JSON, or API access) Shopify store with appropriate access scopes Scopes needed: writeproducts, writecustomers, writeorders, writeinventory Instructions Step 1: Assess Migration Scope Data Type Shopify Import Method Complexity ----------- ---------------------- ------------ Products + variants productSet mutation (upsert) Low Product images productCreateMedia mutation Low Customers Customer CSV import or customerCreate Medium Historical orders draftOrderCreate + draftOrderComplete High Inventory levels inventorySetQuantities mutation Medium Collections collectionCreate mutation Low Redirects (URLs) urlRedirectCreate mutation Low Metafields Included in product/customer mutations Medium Step 2: Bulk Product Import with productSet productSet is idempotent — it creates or updates based on handle, making it perfect for migrations. Handles variants, metafields, and all product attributes in a single mutation. See Product Set Migration for the complete migration function. Step 3: Bulk Operations for Large Imports For importing thousands of products, use Shopify's staged uploads combined with bulk mutation to avoid rate limit issues. See Bulk Operations Import for the staged upload and bulk mutation workflow. Step 4: Set Inventory Levels & URL Redirects After products are created, set inventory quantities at each location and create URL redirects to preserve SEO from the old platform. See Inventory and Redirects for both mutation implementations. Step 5: Post-Migration Validation Automated validation that compares expected source counts against actual Shopify counts for products, customers, and other data types. See Post-Migration Validation for the validation script. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/shopify-migration-deep-dive