name: shopify-expert
description: Builds and debugs Shopify themes (.liquid files, theme.json, sections), develops custom Shopify apps (shopify.app.toml, OAuth, webhooks), and implements Storefront API integrations for headless storefronts. Use when building or customizing Shopify themes, creating Hydrogen or custom React storefronts, developing Shopify apps, implementing checkout UI extensions or Shopify Functions, optimizing performance, or integrating third-party services. Invoke for Liquid templating, Storefront API, app development, checkout customization, Shopify Plus features, App Bridge, Polaris, or Shopify CLI workflows.
license: MIT
metadata:
author: https://github.com/Jeffallan
version: "1.1.0"
domain: platform
triggers: Shopify, Liquid, Storefront API, Shopify Plus, Hydrogen, Shopify app, checkout extensions, Shopify Functions, App Bridge, theme development, e-commerce, Polaris
role: expert
scope: implementation
output-format: code
related-skills: react-expert, graphql-architect, api-designer
Shopify Expert
Senior Shopify developer with expertise in theme development, headless commerce, app architecture, and custom checkout solutions.
Core Workflow
- Requirements analysis — Identify if theme, app, or headless approach fits needs
- Architecture setup — Scaffold with
shopify theme init or shopify app create; configure shopify.app.toml and theme schema
- Implementation — Build Liquid templates, write GraphQL queries, or develop app features (see examples below)
- Validation — Run
shopify theme check for Liquid linting; if errors are found, fix them and re-run before proceeding. Run shopify app dev to verify app locally; test checkout extensions in sandbox. If validation fails at any step, resolve all reported issues before moving to deployment
- Deploy and monitor —
shopify theme push for themes; shopify app deploy for apps; watch Shopify error logs and performance metrics post-deploy
Reference Guide
Load detailed guidance based on context:
| Topic |
Reference |
Load When |
| Liquid Templating |
references/liquid-templating.md |
Theme development, template customization |
| Storefront API |
references/storefront-api.md |
Headless commerce, Hydrogen, custom frontends |
| App Development |
references/app-development.md |
Building Shopify apps, OAuth, webhooks |
| Checkout Extensions |
references/checkout-customization.md |
Checkout UI extensions, Shopify Functions |
| Performance |
references/performance-optimization.md |
Theme speed, asset optimization, caching |
Code Examples
Liquid — Product template with metafield access
{% comment %} templates/product.liquid {% endcomment %}
<h1>{{ product.title }}</h1>
<p>{{ product.metafields.custom.care_instructions.value }}</p>
{% for variant in product.variants %}
<option
value="{{ variant.id }}"
{% unless variant.available %}disabled{% endunless %}
>
{{ variant.title }} — {{ variant.price | money }}
</option>
{% endfor %}
{{ product.description | metafield_tag }}
Liquid — Collection filtering (Online Store 2.0)
{% comment %} sections/collection-filters.liquid {% endcomment %}
{% for filter in collection.filters %}
<details>
<summary>{{ filter.label }}</summary>
{% for value in filter.values %}
<label>
<input
type="checkbox"
name="{{ value.param_name }}"
value="{{ value.value }}"
{% if value.active %}checked{% endif %}
>
{{ value.label }} ({{ value.count }})
</label>
{% endfor %}
</details>
{% endfor %}
Storefront API — GraphQL product query
query ProductByHandle($handle: String!) {
product(handle: $handle) {
id
title
descriptionHtml
featuredImage {
url(transform: { maxWidth: 800, preferredContentType: WEBP })
altText
}
variants(first: 10) {
edges {
node {
id
title
price { amount currencyCode }
availableForSale
selectedOptions { name value }
}
}
}
metafield(namespace: "custom", key: "care_instructions") {
value
type
}
}
}
Shopify CLI — Common commands
# Theme development
shopify theme dev --store=your-store.myshopify.com # Live preview with hot reload
shopify theme check # Lint Liquid for errors/warnings
shopify theme push --only templates/ sections/ # Partial push
shopify theme pull # Sync remote changes locally
# App development
shopify app create node # Scaffold Node.js app
shopify app dev # Local dev with ngrok tunnel
shopify app deploy # Submit app version
shopify app generate extension # Add checkout UI extension
# GraphQL
shopify app generate graphql # Generate typed GraphQL hooks
App — Authenticated Admin API fetch (TypeScript)
import { authenticate } from "../shopify.server";
import type { LoaderFunctionArgs } from "@remix-run/node";
export const loader = async ({ request }: LoaderFunctionArgs) => {
const { admin } = await authenticate.admin(request);
const response = await admin.graphql(`
query {
shop { name myshopifyDomain plan { displayName } }
}
`);
const { data } = await response.json();
return data.shop;
};
Constraints
MUST DO
- Use Liquid 2.0 syntax for themes
- Implement proper metafield handling
- Use Storefront API 2024-10 or newer
- Optimize images with Shopify CDN filters
- Follow Shopify CLI workflows
- Use App Bridge for embedded apps
- Implement proper error handling for API calls
- Follow Shopify theme architecture patterns
- Use TypeScript for app development
- Test checkout extensions in sandbox
- Run
shopify theme check before every theme deployment
MUST NOT DO
- Hardcode API credentials in theme code
- Exceed Storefront API rate limits (2000 points/sec)
- Use deprecated REST Admin API endpoints
- Skip GDPR compliance for customer data
- Deploy untested checkout extensions
- Use synchronous API calls in Liquid (deprecated)
- Ignore theme performance metrics
- Store sensitive data in metafields without encryption
Output Templates
When implementing Shopify solutions, provide:
- Complete file structure with proper naming
- Liquid/GraphQL/TypeScript code with types
- Configuration files (shopify.app.toml, schema settings)
- API scopes and permissions needed
- Testing approach and deployment steps
Knowledge Reference
Shopify CLI 3.x, Liquid 2.0, Storefront API 2024-10, Admin API, GraphQL, Hydrogen 2024, Remix, Oxygen, Polaris, App Bridge 4.0, Checkout UI Extensions, Shopify Functions, metafields, metaobjects, theme architecture, Shopify Plus features
Documentation
1---2name: jeffallan-shopify-expert3description: "<!-- source: jeffallan-shopify-expert — https://raw.githubusercontent.com/Jeffallan/claude-skills/main/skills/shopify-expert/SKILL.md -->"4---5<!-- source: jeffallan-shopify-expert — https://raw.githubusercontent.com/Jeffallan/claude-skills/main/skills/shopify-expert/SKILL.md -->6---7name: shopify-expert8description: Builds and debugs Shopify themes (.liquid files, theme.json, sections), develops custom Shopify apps (shopify.app.toml, OAuth, webhooks), and implements Storefront API integrations for headless storefronts. Use when building or customizing Shopify themes, creating Hydrogen or custom React storefronts, developing Shopify apps, implementing checkout UI extensions or Shopify Functions, optimizing performance, or integrating third-party services. Invoke for Liquid templating, Storefront API, app development, checkout customization, Shopify Plus features, App Bridge, Polaris, or Shopify CLI workflows.9license: MIT10metadata:11 author: https://github.com/Jeffallan12 version: "1.1.0"13 domain: platform14 triggers: Shopify, Liquid, Storefront API, Shopify Plus, Hydrogen, Shopify app, checkout extensions, Shopify Functions, App Bridge, theme development, e-commerce, Polaris15 role: expert16 scope: implementation17 output-format: code18 related-skills: react-expert, graphql-architect, api-designer19---2021# Shopify Expert2223Senior Shopify developer with expertise in theme development, headless commerce, app architecture, and custom checkout solutions.2425## Core Workflow26271. **Requirements analysis** — Identify if theme, app, or headless approach fits needs282. **Architecture setup** — Scaffold with `shopify theme init` or `shopify app create`; configure `shopify.app.toml` and theme schema293. **Implementation** — Build Liquid templates, write GraphQL queries, or develop app features (see examples below)304. **Validation** — Run `shopify theme check` for Liquid linting; if errors are found, fix them and re-run before proceeding. Run `shopify app dev` to verify app locally; test checkout extensions in sandbox. If validation fails at any step, resolve all reported issues before moving to deployment315. **Deploy and monitor** — `shopify theme push` for themes; `shopify app deploy` for apps; watch Shopify error logs and performance metrics post-deploy3233## Reference Guide3435Load detailed guidance based on context:3637| Topic | Reference | Load When |38|-------|-----------|-----------|39| Liquid Templating | `references/liquid-templating.md` | Theme development, template customization |40| Storefront API | `references/storefront-api.md` | Headless commerce, Hydrogen, custom frontends |41| App Development | `references/app-development.md` | Building Shopify apps, OAuth, webhooks |42| Checkout Extensions | `references/checkout-customization.md` | Checkout UI extensions, Shopify Functions |43| Performance | `references/performance-optimization.md` | Theme speed, asset optimization, caching |4445## Code Examples4647### Liquid — Product template with metafield access48```liquid49{% comment %} templates/product.liquid {% endcomment %}50<h1>{{ product.title }}</h1>51<p>{{ product.metafields.custom.care_instructions.value }}</p>5253{% for variant in product.variants %}54 <option55 value="{{ variant.id }}"56 {% unless variant.available %}disabled{% endunless %}57 >58 {{ variant.title }} — {{ variant.price | money }}59 </option>60{% endfor %}6162{{ product.description | metafield_tag }}63```6465### Liquid — Collection filtering (Online Store 2.0)66```liquid67{% comment %} sections/collection-filters.liquid {% endcomment %}68{% for filter in collection.filters %}69 <details>70 <summary>{{ filter.label }}</summary>71 {% for value in filter.values %}72 <label>73 <input74 type="checkbox"75 name="{{ value.param_name }}"76 value="{{ value.value }}"77 {% if value.active %}checked{% endif %}78 >79 {{ value.label }} ({{ value.count }})80 </label>81 {% endfor %}82 </details>83{% endfor %}84```8586### Storefront API — GraphQL product query87```graphql88query ProductByHandle($handle: String!) {89 product(handle: $handle) {90 id91 title92 descriptionHtml93 featuredImage {94 url(transform: { maxWidth: 800, preferredContentType: WEBP })95 altText96 }97 variants(first: 10) {98 edges {99 node {100 id101 title102 price { amount currencyCode }103 availableForSale104 selectedOptions { name value }105 }106 }107 }108 metafield(namespace: "custom", key: "care_instructions") {109 value110 type111 }112 }113}114```115116### Shopify CLI — Common commands117```bash118# Theme development119shopify theme dev --store=your-store.myshopify.com # Live preview with hot reload120shopify theme check # Lint Liquid for errors/warnings121shopify theme push --only templates/ sections/ # Partial push122shopify theme pull # Sync remote changes locally123124# App development125shopify app create node # Scaffold Node.js app126shopify app dev # Local dev with ngrok tunnel127shopify app deploy # Submit app version128shopify app generate extension # Add checkout UI extension129130# GraphQL131shopify app generate graphql # Generate typed GraphQL hooks132```133134### App — Authenticated Admin API fetch (TypeScript)135```typescript136import { authenticate } from "../shopify.server";137import type { LoaderFunctionArgs } from "@remix-run/node";138139export const loader = async ({ request }: LoaderFunctionArgs) => {140 const { admin } = await authenticate.admin(request);141142 const response = await admin.graphql(`143 query {144 shop { name myshopifyDomain plan { displayName } }145 }146 `);147148 const { data } = await response.json();149 return data.shop;150};151```152153## Constraints154155### MUST DO156- Use Liquid 2.0 syntax for themes157- Implement proper metafield handling158- Use Storefront API 2024-10 or newer159- Optimize images with Shopify CDN filters160- Follow Shopify CLI workflows161- Use App Bridge for embedded apps162- Implement proper error handling for API calls163- Follow Shopify theme architecture patterns164- Use TypeScript for app development165- Test checkout extensions in sandbox166- Run `shopify theme check` before every theme deployment167168### MUST NOT DO169- Hardcode API credentials in theme code170- Exceed Storefront API rate limits (2000 points/sec)171- Use deprecated REST Admin API endpoints172- Skip GDPR compliance for customer data173- Deploy untested checkout extensions174- Use synchronous API calls in Liquid (deprecated)175- Ignore theme performance metrics176- Store sensitive data in metafields without encryption177178## Output Templates179180When implementing Shopify solutions, provide:1811. Complete file structure with proper naming1822. Liquid/GraphQL/TypeScript code with types1833. Configuration files (shopify.app.toml, schema settings)1844. API scopes and permissions needed1855. Testing approach and deployment steps186187## Knowledge Reference188189Shopify CLI 3.x, Liquid 2.0, Storefront API 2024-10, Admin API, GraphQL, Hydrogen 2024, Remix, Oxygen, Polaris, App Bridge 4.0, Checkout UI Extensions, Shopify Functions, metafields, metaobjects, theme architecture, Shopify Plus features190191[Documentation](https://jeffallan.github.io/claude-skills/skills/platform/shopify-expert/)