Official Shopify skill for theme development in Liquid — teaches an agent the modern theme architecture of sections, blocks and snippets, and validates generated templates and schemas.
Shopify Admin GraphQL Skill
Shopify's official skill for writing Admin GraphQL queries and mutations — it searches the live API docs and validates every operation against the schema before handing you code.
Install
Other ways to install
About
- Searches the live shopify.dev Admin API docs before writing any operation
- Validates generated GraphQL against the real schema, with a three-try fix loop
- Targets a specific API version (e.g. 2026-04) or the latest stable
- Encodes Shopify's own conventions — field-count limits, __typename on unions, search syntax
- Hands off config validation and live execution to the toolkit's CLI skill
Part of the Shopify AI Toolkit, shopify-admin is the skill you want any time an agent is about to write an Admin GraphQL query or mutation.
The problem it solves
The Shopify Admin API is large and versioned quarterly, and a model working from training data reliably invents field names, guesses at input types, and reaches for mutations that were renamed two versions ago. The code looks right and fails at runtime.
How it works around that
The skill forces a fixed loop on every response, and it is unusually blunt about it:
- Search first.
scripts/search_docs.mjs "<query>" --version API_VERSIONagainst shopify.dev, searching for the operation name rather than the user's full prompt. - Write the operation from what the search actually returned, linking the docs pages used.
- Validate before returning.
scripts/validate.mjschecks the generated GraphQL against the real schema for the target API version. - On failure, re-search and retry — up to three times — fixing exactly the field or type the validator named rather than guessing.
- Only then is code allowed back to the user.
It also encodes house style: don't select more than about five fields, request __typename on union types, and pull /docs/api/usage/search-syntax when the user wants advanced query filtering.
Boundaries
The skill is careful about handing off. Validating app or extension configuration, or actually executing Admin GraphQL against a live store, belongs to the toolkit's use-shopify-cli skill instead — this one designs and explains the operation.
Requirements and caveats
Node.js must be present, since the skill runs .mjs scripts on every turn. Those scripts send usage telemetry to shopify.dev — including the search query, the validated code, and your most recent message — which you can switch off with OPT_OUT_INSTRUMENTATION=true. MIT licensed.
Try it
Once installed, ask your agent something like:
Write me an Admin GraphQL mutation that adjusts inventory quantities in bulk for a set of variants at one location.
SKILL.md
The instructions your agent loads, as published by Shopify.
Related Skills
See all Shopify Admin GraphQL alternativesSkill: Shopify Checkout UI Extensions
by Shopify
Official Shopify skill for building checkout and thank-you page UI extensions — it carries the full extension-target list and validates components against the current UI framework version.
Skill: Shopify Functions
by Shopify
Official Shopify skill for writing Shopify Functions — the sandboxed backend logic behind discounts, cart transforms, delivery and payment customisation, validation and order routing.
Firebase's official skill for building and deploying Firebase SQL Connect (formerly Data Connect) backends on Cloud SQL for PostgreSQL: GraphQL schemas, authorized queries and mutations, realtime updates and generated type-safe SDKs.