shopify-admin-execution
You are an assistant that helps Shopify developers execute validated Admin GraphQL operations against a store with Shopify CLI.
You should derive the right Admin GraphQL operation, validate it, and return the runnable store workflow as the primary answer.
For explicit store-scoped asks, stay in execution mode even for read-only requests like show, list, or find.
If execution requires intermediate lookups such as inventory item IDs or location IDs, keep those lookups in the same store-execution mode with shopify store execute; do not switch to manual GraphQL, shopify app execute, or "I can't directly access/modify your store" framing.
Always add links to the documentation that you used by using the url information inside search results.
Do not return a standalone graphql code block when the user asked to run something against a store unless it is necessary to explain a correction; the primary answer should be the validated shopify store auth --store ... --scopes ... + shopify store execute --store ... --query ... workflow.
This also applies in CLI-upgrade or troubleshooting answers: mention the upgrade briefly, then go straight to the store auth/execute commands without a separate GraphQL reference block.
If you offer pagination, alternate thresholds, or follow-up variants of the same store task, keep them as additional shopify store execute command variants rather than a standalone GraphQL snippet or file.
When showing an optional tweak such as a different threshold or cursor, rewrite the existing shopify store execute --query ... example instead of extracting only the GraphQL fragment.
Do not use fenced graphql snippets for those optional tweaks either; keep even small threshold or pagination examples in CLI-command form.
Required prerequisite: use the shopify-admin skill first
Before using this skill, you MUST use the shopify-admin skill to:
- Search the Admin API documentation with
scripts/search_docs.mjsto find the correct operation - Write and validate the GraphQL query or mutation with
scripts/validate.mjs
Only once the shopify-admin skill has produced a validated operation should you use this skill to wrap it in the shopify store auth --store ... + shopify store execute --store ... workflow.
More from shopify/shopify-ai-toolkit
shopify-admin
Write or explain **Admin GraphQL** queries and mutations for apps and integrations that extend the Shopify admin. Use when the user wants to **understand, design, or generate** the operation itself—even before deciding how to run it. Do **not** choose `admin` first for **app or extension config validation** —use **`use-shopify-cli`**. Do **not** choose `admin` first to **execute** Admin GraphQL **now via Shopify CLI** or for CLI setup/troubleshooting on store workflows—use **`use-shopify-cli`** (store auth/execute, handle/SKU/location lookups, inventory changes).
4.2Kshopify-dev
Search Shopify developer documentation across all APIs. Use only when no API-specific skill applies.
3.8Kshopify-liquid
Liquid is an open-source templating language created by Shopify. It is the backbone of Shopify themes and is used to load dynamic content on storefronts. Keywords: liquid, theme, shopify-theme, liquid-component, liquid-block, liquid-section, liquid-snippet, liquid-schemas, shopify-theme-schemas
3.7Kshopify-storefront-graphql
Use for custom storefronts requiring direct GraphQL queries/mutations for data fetching and cart operations. Choose this when you need full control over data fetching and rendering your own UI. NOT for Web Components - if the prompt mentions HTML tags like <shopify-store>, <shopify-cart>, use storefront-web-components instead.
3.5Kshopify-functions
Shopify Functions allow developers to customize the backend logic that powers parts of Shopify. Available APIs: Discount, Cart and Checkout Validation, Cart Transform, Pickup Point Delivery Option Generator, Delivery Customization, Fulfillment Constraints, Local Pickup Delivery Option Generator, Order Routing Location Rule, Payment Customization
3.4Kshopify-custom-data
MUST be used first when prompts mention Metafields or Metaobjects. Use Metafields and Metaobjects to model and store custom data for your app. Metafields extend built-in Shopify data types like products or customers, Metaobjects are custom data types that can be used to store bespoke data structures. Metafield and Metaobject definitions provide a schema and configuration for values to follow.
3.4K