shopify-developer
/shopify-developer
Shopify theme, Liquid, Hydrogen and app development reference, with live API lookups handed to Shopify's own tooling. Use when editing .liquid files, building OS 2.0 sections, blocks or JSON templates, wiring theme cart behaviour with the Ajax API, speeding up a slow Shopify storefront, debugging Liquid or theme editor errors, building or upgrading a Hydrogen storefront, scaffolding a Shopify app or extension, writing Shopify Functions, or picking a Shopify API version. Do NOT use for WooCommerce, Magento, BigCommerce or other platforms - answer from general knowledge; Do NOT use for exact Gra
- Author
- henkisdabro ↗
- Repository
- wookstar-claude-plugins ↗
- Licence
- MIT
- Last repository change
- 04.10.2026
Assessment and security
- Files in this package
- 11
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 3
No signals detected. Repository changed on 04.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Shopify theme, Liquid, Hydrogen and app development reference, with live API lookups handed to Shopify's own tooling. Use when editing .liquid files, building OS 2.0 sections, blocks or JSON templates, wiring theme cart behaviour with the Ajax API, speeding up a slow Shopify storefront, debugging Liquid or theme editor errors, building or upgrading a Hydrogen storefront, scaffolding a Shopify app or extension, writing Shopify Functions, or picking a Shopify API version. Do NOT use for WooCommerce, Magento, BigCommerce or other platforms - answer from general knowledge; Do NOT use for exact Gra
Original author description
Shopify theme, Liquid, Hydrogen and app development reference, with live API lookups handed to Shopify's own tooling. Use when editing .liquid files, building OS 2.0 sections, blocks or JSON templates, wiring theme cart behaviour with the Ajax API, speeding up a slow Shopify storefront, debugging Liquid or theme editor errors, building or upgrading a Hydrogen storefront, scaffolding a Shopify app or extension, writing Shopify Functions, or picking a Shopify API version. Do NOT use for WooCommerce, Magento, BigCommerce or other platforms - answer from general knowledge; Do NOT use for exact Gra
How it works
- Workflow
- Branches
- Live schema and docs: Shopify's tooling
- API versioning rule
- Retired platform features
- Liquid at a glance
SKILL.md preview
---
name: shopify-developer
description: Shopify theme, Liquid, Hydrogen and app development reference, with live API lookups handed to Shopify's own tooling. Use when editing .liquid files, building OS 2.0 sections, blocks or JSON templates, wiring theme cart behaviour with the Ajax API, speeding up a slow Shopify storefront, debugging Liquid or theme editor errors, building or upgrading a Hydrogen storefront, scaffolding a Shopify app or extension, writing Shopify Functions, or picking a Shopify API version. Do NOT use for WooCommerce, Magento, BigCommerce or other platforms - answer from general knowledge; Do NOT use for exact GraphQL field or schema lookups - use the shopify-ai-toolkit plugin or @shopify/dev-mcp.
---
# 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
| Task | Read |
|------|------|
| Writing or fixing `.liquid` | [liquid-syntax.md](references/liquid-syntax.md), then [liquid-filters.md](references/liquid-filters.md) or [liquid-objects.md](references/liquid-objects.md) as needed |
| Sections, blocks, JSON templates, settings schema, theme structure | [theme-development.md](references/theme-development.md) |
| Theme cart (`/cart/*.js`), calling any Shopify API, rate limits, webhooks | [api.md](references/api.md) |
| Slow storefront, Core Web Vitals, image sizing | [performance.md](references/performance.md) |
| Something broken: Liquid errors, theme editor, cart, API or webhook failures | [debugging.md](references/debugging.md) |
| Headless storefront, Hydrogen upgrade, Oxygen | [hydrogen.md](references/hydrogen.md) |
| New or existing Shopify app, extensions, admin UI | [app-development.md](references/app-development.md) |
| Discounts, delivery/payment customisation, cart validation, anything that used to be a Script | [functions.md](references/functions.md) |
## Live schema and docs: Shopify's tooling
For field names, argument shapes, deprecations and validation, defer to Shopify's official tooling instead of the reference files:
```bash
# Claude Code plugin (skills plus the Dev MCP server)
claude plugin install shopify-ai-toolkit@claude-plugins-official
# Dev MCP server on its own
claude mcp add --transport stdio shopify-dev-mcp -- npx -y @shopify/dev-mcp@latest
```
Both validate GraphQL against Shopify's schemas and validate Liquid. Check <https://shopify.dev/docs/apps/build/devmcp> if a command fails - the install line is Shopify's to change.
## API versioning rule
Shopify releases an API version every quarter, named `YYYY-01`, `YYYY-04`, `YYYY-07`, `YYYY-10`, each supported for at least 12 months. A request for an unsupported version is served by the oldest supported one, which silently changes behaviour. There is no permanent "current" version to remember: look it up at <https://shopify.dev/docs/api/usage/versioning> each time.
## Retired platform features
| Gone | Use instead |
|------|-------------|
| Shopify Scripts - stopped executing 30 June 2026 | Shopify Functions ([functions.md](references/functions.md)) |
| `checkout.liquid` | Checkout UI extensions and Functions |
| REST Admin API for new work | GraphQL Admin API |
| Polaris React (`@shopify/polaris`, deprecated on npm) | Polaris web components (`<s-page>`, `<s-button>`) |
| Shopify Remix app template | React Router app template (`@shopify/shopify-app-react-router`) |
| `img_url` filter | `image_url` plus `image_tag` |
| `{% include %}` | `{% render %}` |
## Liquid at a glance
```liquid
{{ product.title | escape }}
{%- if product.available -%}In stock{%- endif -%}
{% render 'product-card', product: product %}
{{ product.featured_image | image_url: width: 800 | image_tag: loading: 'lazy' }}
```
Files in this package (11)
- SKILL.md 5 KB
- references/api.md 5 KB
- references/app-development.md 6 KB
- references/debugging.md 6 KB
- references/functions.md 4 KB
- references/hydrogen.md 10 KB
- references/liquid-filters.md 13 KB
- references/liquid-objects.md 21 KB
- references/liquid-syntax.md 12 KB
- references/performance.md 13 KB
- references/theme-development.md 23 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · henkisdabro/wookstar-claude-plugins | 100 | MIT |
| tech-leads-club/agent-skills | 100 | MIT |
Database snapshot: 13.11.2026 · package version 110c224de8ca (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100shopify
Build and customize Shopify stores — themes with Liquid, Storefront API, custom apps, and headless commerce with Hydrogen. Use when someone asks to "build a Shopify store", "Shopify theme", "Liquid templates", "Shopify API", "Shopify app", "headless Shopify", "Hydrogen… - 100shopify-dev
Shopify Developer. Activate when a user is building or modifying a Shopify theme, app, or integration. Triggers on: "add a section to my theme", "create a Shopify app", "Shopify CLI", "Liquid template", "Storefront API", "Admin API", "checkout extension", "Hydrogen", "Polaris",… - 100shopify-expert
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… - 92shopify
Build anything on Shopify. One skill covering every Shopify developer surface: Use Shopify CLI, Admin API, ShopifyQL, Storefront GraphQL API, Partner API, Customer Account API, Payments Apps API, Shopify Functions, Polaris App Home, Polaris Admin Extensions, Polaris Checkout… - 100shopify-expert
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… - 100shopify-storefront-headless
Build headless storefronts with Shopify''s Storefront API and Cart API. Use when building custom frontends, setting up Hydrogen, querying products for customer-facing apps, or managing cart operations programmatically. Trigger with phrases like "shopify headless", "shopify…