shopify-developer — Claude Code skill: what it does, how to install
shopify-developer gives the agent a Shopify reference: Liquid, OS 2.0 themes, GraphQL APIs, Functions and Hydrogen, all pinned to API version 2026-01.
MIT ★ 7,191 updated 2026-10-24
npx skills add tech-leads-club/agent-skills --skill shopify-developer -a claude-codeWhat shopify-developer does
A reference pack for Shopify work, aimed at the agent rather than at you. It covers Liquid templating, OS 2.0 themes, the Admin and Storefront GraphQL APIs, app extensions, Shopify Functions and Hydrogen storefronts. Everything follows API version 2026-01.
The skill is split into topic files: Liquid syntax, filters and objects, theme architecture, Admin API, Storefront and Ajax API, app development, Functions, Hydrogen, performance, debugging. The agent pulls in the file that matches the task instead of loading the lot. A deprecation table flags the moves already underway: Scripts toward Functions, REST toward GraphQL, Polaris React toward Web Components.
Local theme and app work needs the Shopify CLI, installed globally with npm install -g @shopify/cli; then shopify theme dev --store {store}.myshopify.com starts a preview. The skill stays inside Shopify, so on a different commerce platform its answers will miss.
What it helps with
- build an OS 2.0 section with a settings schema
- track down a Liquid error that breaks template rendering
- write a GraphQL Admin API mutation that creates an order
- port discount logic from Shopify Scripts to a Function
- set up a headless storefront in Hydrogen
Example prompts for the agent
- Fix
product.liquid, the price disappears when a product has several variants - Write an Admin API query that returns orders from the past week
- Port our discount from Shopify Scripts to a Rust Function
How to install shopify-developer
1Skills CLI (Vercel)
npx skills add tech-leads-club/agent-skills --skill shopify-developer -a claude-code2Manually: put the files in place
~/.claude/skills/shopify-developer/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/shopify-developer/
1Skills CLI (Vercel)
npx skills add tech-leads-club/agent-skills --skill shopify-developer -a codex2Manually: put the files in place
.agents/skills/shopify-developer/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add tech-leads-club/agent-skills --skill shopify-developer -a cursor2Manually: put the files in place
.cursor/skills/shopify-developer/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install tech-leads-club/agent-skills 'packages/skills-catalog/skills/(development)/shopify-developer'2Manually: put the files in place
.github/skills/shopify-developer/SKILL.md1Skills CLI (Vercel)
npx skills add tech-leads-club/agent-skills --skill shopify-developer -a gemini-cli2Platform CLI
gemini skills install https://github.com/tech-leads-club/agent-skills --path 'packages/skills-catalog/skills/(development)/shopify-developer'Manually: put the files in place
.devin/skills/shopify-developer/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about shopify-developer
How to install shopify-developer in Claude Code?
Run npx skills add tech-leads-club/agent-skills --skill shopify-developer -a claude-code. The skill file lands at ~/.claude/skills/shopify-developer/SKILL.md.
What does shopify-developer do?
It hands the agent Shopify material to work from: Liquid, OS 2.0 themes, the Admin and Storefront GraphQL APIs, app development, Functions, Hydrogen, performance and debugging.
Which Shopify API version does the skill target?
2026-01. The Admin and Storefront GraphQL endpoints the agent writes into requests belong to that version.
Source text
SKILL.md · MIT
---
name: shopify-developer
description: Complete Shopify development reference covering Liquid templating, OS 2.0 themes, GraphQL APIs, Hydrogen, Functions, and performance optimization (API v2026-01). Use when working with .liquid files, building Shopify themes or apps, writing GraphQL queries for Shopify, debugging Liquid errors, creating app extensions, migrating from Scripts to Functions, or building headless storefronts. Triggers on "Shopify", "Liquid template", "Hydrogen", "Storefront API", "theme development", "Shopify Functions", "Polaris". Do NOT use for non-Shopify e-commerce platforms.
---
# Shopify Developer Reference
Comprehensive reference for professional Shopify development - API version **2026-01**.
## Quick Reference
| Item | Value |
| ---------------- | ------------------------------------------------------------------- |
| API version | `2026-01` (stable) |
| GraphQL Admin | `POST https://{store}.myshopify.com/admin/api/2026-01/graphql.json` |
| Storefront API | `POST https://{store}.myshopify.com/api/2026-01/graphql.json` |
| Ajax API (theme) | `/cart.js`, `/cart/add.js`, `/cart/change.js` |
| CLI install | `npm install -g @shopify/cli` |
| Theme dev | `shopify theme dev --store {store}.myshopify.com` |
| App dev | `shopify app dev` |
| Deploy | `shopify app deploy` |
| Docs | [shopify.dev](https://shopify.dev) |
## Choose Your Path
Read the reference file(s) that match your task:
**Liquid templating** - writing or debugging `.liquid` files:
- [references/liquid-syntax.md](references/liquid-syntax.md) - Tags, control flow, iteration, whitespace, LiquidDoc
- [references/liquid-filters.md](references/liquid-filters.md) - All filter categories with examples
- [references/liquid-objects.md](references/liquid-objects.md) - Product, collection, cart, customer, and global objects
**Theme development** - building or customising themes:
- [references/theme-development.md](references/theme-development.md) - OS 2.0 architecture, sections, blocks, JSON templates, settings schema
**API integration** - fetching or modifying data programmatically:
- [references/api-admin.md](references/api-admin.md) - GraphQL Admin API (primary), REST (legacy), OAuth, webhooks, rate limiting
- [references/api-storefront.md](references/api-storefront.md) - Storefront API, Ajax API, cart operations
**App development** - building Shopify apps:
- [references/app-development.md](references/app-development.md) - Shopify CLI, extensions, Polaris Web Components, App Bridge
**Serverless logic** - custom business rules:
- [references/functions.md](references/functions.md) - Shopify Functions (replacing Scripts), Rust/JS targets, deployment
**Headless commerce** - custom storefronts:
- [references/hydrogen.md](references/hydrogen.md) - Hydrogen framework, React Router 7, Storefront API integration
**Optimisation and troubleshooting**:
- [references/performance.md](references/performance.md) - Images, JS, CSS, fonts, Liquid, Core Web Vitals
- [references/debugging.md](references/debugging.md) - Liquid errors, API errors, cart issues, webhook failures
## Deprecation Notices
| Deprecated | Replacement | Deadline |
| --------------------- | ---------------------- | ---------------------------------------- |
| Shopify Scripts | Shopify Functions | August 2025 (migration), sundown TBD |
| checkout.liquid | Checkout Extensibility | August 2024 (Plus), done |
| REST Admin API | GraphQL Admin API | Active deprecation (no removal date yet) |
| Legacy custom apps | New auth model | January 2025 (done) |
| Polaris React | Polaris Web Components | Active migration |
| Remix (app framework) | React Router 7 | Hydrogen 2025.5.0+ |
## Liquid Essentials
Three syntax types:
```liquid
{{ product.title | upcase }} {# Output with filter #}
{% if product.available %}In stock{% endif %} {# Logic tag #}
{% assign sale = product.price | times: 0.8 %} {# Assignment #}
{%- if condition -%}Stripped whitespace{%- endif -%}
```
Key patterns:
```liquid
{% for product in collection.products limit: 5 %}
{% render 'product-card', product: product %}
{% endfor %}
{% paginate collection.products by 12 %}
{% for product in paginate.collection.products %}...{% endfor %}
{{ paginate | default_pagination }}
{% endpaginate %}
```
## API Essentials
```javascript
// GraphQL Admin - always use GraphQL over REST
const response = await fetch(`https://${store}.myshopify.com/admin/api/2026-01/graphql.json`, {
method: 'POST',
headers: {
'X-Shopify-Access-Token': accessToken,
'Content-Type': 'application/json',
},
body: JSON.stringify({ query, variables }),
})
const { data, errors } = await response.json()
if (errors) throw new Error(errors[0].message)
// Ajax API (theme-only cart operations)
fetch('/cart/add.js', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ id: variantId, quantity: 1 }),
})
```
## Reference Files
| File | Lines | Coverage |
| ------------------------------------------------------- | ----- | ------------------------------------------------------------------------------ |
| [liquid-syntax.md](references/liquid-syntax.md) | ~600 | Tags, control flow, iteration, variables, whitespace, LiquidDoc |
| [liquid-filters.md](references/liquid-filters.md) | ~870 | String, numeric, array, Shopify-specific, date, URL, colour filters |
| [liquid-objects.md](references/liquid-objects.md) | ~695 | All Shopify objects: product, variant, collection, cart, customer, order, etc. |
| [theme-development.md](references/theme-development.md) | ~1200 | File structure, JSON templates, sections, blocks, settings schema, layout |
| [api-admin.md](references/api-admin.md) | ~595 | GraphQL queries/mutations, REST (legacy), OAuth, webhooks, rate limiting |
| [api-storefront.md](references/api-storefront.md) | ~235 | Storefront API, Ajax API, cart operations, Customer Account API |
| [app-development.md](references/app-development.md) | ~760 | CLI, app architecture, extensions, Polaris Web Components, deployment |
| [functions.md](references/functions.md) | ~300 | Function types, Rust/JS targets, CLI workflow, Scripts migration |
| [hydrogen.md](references/hydrogen.md) | ~375 | Setup, routing, data loading, Storefront API, deployment |
| [performance.md](references/performance.md) | ~605 | Images, JS, CSS, fonts, Liquid, third-party scripts, Core Web Vitals |
| [debugging.md](references/debugging.md) | ~650 | Liquid, JavaScript, API, cart, webhook, theme editor troubleshooting |
© tech-leads-club · MIT · tech-leads-club/agent-skills