Shopify Developer

Knowledge for Liquid themes, Hydrogen and Shopify apps. Exact API schemas change every quarter, so this skill carries orientation and gotchas; Shopify's own tooling carries the live schema.

Workflow

1. Pick the branch from the table below and read only those reference files. Done when you have read every file the task's branch lists.
2. Pin the API version. Any code that names a version (api_version in a TOML file, an endpoint URL, ApiVersion.*) takes the latest stable version from https://shopify.dev/docs/api/usage/versioning, or the version the project already pins if the task is not an upgrade. Done when every version string you write was read from that page or the project, never from memory.
3. Validate against the live schema when the change touches GraphQL (Admin, Storefront, Customer Account, Function input queries) or Liquid you are unsure of: use the shopify-ai-toolkit plugin or @shopify/dev-mcp (setup below). If neither is installed, tell the user, give them the install command, and mark the GraphQL as unvalidated. Done when each query or mutation was validated, or flagged as unvalidated in your reply.
4. Run the project's own check - shopify theme check for themes, shopify app build or the project's typecheck for apps and Hydrogen. Done when it passes or the remaining failures are reported.

Branches