Terminal
Terminal/Skill
Helps your agent fit validated Shopify Storefront or Customer Account GraphQL into the Vercel Shop template's structure and caching.
By Vercel
Works with
npx skills add vercel/shop --skill shopify-graphql-referenceTreat Shopify AI Toolkit as authoritative for Shopify documentation, schemas, fields, arguments, enum values, API versions, operation design, and validation. This skill owns only the Vercel Shop integration layer.
Read references/REFERENCE.md before editing.
lib/shopify/operations/<resource>/server.ts in the closest resource domain as an uncached fetch* function with no next/cache import. Put the cache directive, cacheLife, and cacheTag calls in a get* wrapper in the consuming domain's lib/<domain>/server.ts (for example lib/product/server.ts, lib/collections/server.ts, lib/policies/server.ts). Keep pure transforms in lib/shopify/transforms/<resource>/index.ts, named shared contracts in the owning domain's types.ts, and reusable fragment documents in their resource domain. Import implementations and types directly; do not add barrels or forwarding exports.gql() with a leading #graphql comment, keep them static, and use variables for dynamic values. Inference supplies types; Shopify AI Toolkit validates fields and arguments.gql(source, [FRAGMENT]) list. Extend a shared fragment only when multiple operations need the same selection.locale to storefront.request when Shopify localizes the result; never add country or language to variables.ResultOf<typeof FRAGMENT> under lib/shopify/**; transform catalog/account data into domain types before presentation. Cart types intentionally derive from Hydrogen handlers through lib/cart/types.ts.getCart, so cart mutations need no cache invalidation step.Do not present this skill as a Shopify schema source. Shopify AI Toolkit determines what Shopify supports; this skill determines how validated operations fit Vercel Shop.