Agent skill · software engineering · jeremylongshore
shopify-storefront-headless
Build headless storefronts with Shopify''s Storefront API and Cart API.
Why this skill is useful
Provides specific implementation patterns and API usage for Shopify's Storefront and Cart APIs that the AI wouldn't reliably generate on its own.
What it needs
Requires node installed locally. Requires shopify account access. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Shopify Storefront & Headless Commerce Overview The Storefront API is Shopify's public-facing GraphQL API for customer experiences. Unlike the Admin API (server-side, privileged), it uses a public access token safe for client-side code. Paired with the Cart API, it powers headless storefronts, mobile apps, and custom buying experiences. Prerequisites Shopify store with a Storefront API access token (Headless channel or custom app) For Hydrogen: Node.js 18+ and Shopify CLI 3.x+ Storefront API scopes: unauthenticatedreadproducts, unauthenticatedreadcollections Instructions Step 1: Storefront API Client Setup Step 2: Cart Operations Full cart mutations (cartLinesAdd, cartLinesUpdate, cartLinesRemove, cartDiscountCodesUpdate) in cart-api.md. Step 3: Query Products (Storefront Schema) Step 4: Storefront vs Admin API Decision Guide Concern Storefront API Admin API --------- --------------- ----------- Token type Public (safe in browser) Private (server-only) Rate limiting Request-based Query cost-based (1000 pts/sec) Cart/Checkout Full cart + checkout URL No cart operations Product data Customer-facing fields only Full data + inventory Mutations Cart, customer, checkout Full CRUD on all resources Detailed comparison in storefront-vs-admin.md. Hydrogen framework setup in hydrogen-patterns.md. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/shopify-storefront-headless