Shopify Hydrogen storefronts
Shopify's skills for Hydrogen storefronts: routing, the Storefront API client, cart, variants, markets, customer accounts, search and Oxygen deploys.
Category: Frontend. By playbookrun. Reviewed by PlaybookRun before publishing. Installs in Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI and more.
Tags: shopify, hydrogen, storefront, oxygen, e-commerce
Skills
- Hydrogen Routing (hydrogen-routing): Guide for Hydrogen route templates and Shopify storefront URL routing. Use when adding, modifying, or reviewing defineShopifyRouteTemplates, routeTemplates, custom Shopify resource or utility-page paths, handleShopifyRoutes, standard route redirects, ShopifyScripts routes, predictive search result URLs, or localized path prefixes from defineShopifyI18n.
- `@shopify/hydrogen` (hydrogen-storefront-client): Guide for @shopify/hydrogen — the type-safe Storefront API GraphQL client. Use when writing, modifying, or reviewing code that creates a storefront client, writes GraphQL queries with gql(), handles SFAPI errors, or wires up storefront data fetching in any framework.
- Cart Primitive (hydrogen-cart-ui): Behavioral guide for building cart UI with @shopify/hydrogen: line items, quantity and remove controls, optimistic updates, discount, note, and cart attribute inputs, and the full-page /cart fallback. Use when writing, modifying, or reviewing cart line-item UI, quantity/remove controls, cart mutation forms, or code that changes the cart without a form. Framework agnostic.
- Cart Drawer (hydrogen-cart-drawer): Guide for building an accessible cart drawer using @shopify/hydrogen. Use when creating or reviewing a cart drawer, mini cart, or slide-out cart, including native dialog element (showModal), closedby light dismiss, body scroll lock, exit animations, and wiring window.Shopify.actions.openCart().
- Product Form Primitive (hydrogen-variant-form): Behavioral guide for building product variant selection UI with @shopify/hydrogen. Use when writing, modifying, or reviewing product option selectors, variant pickers, or add-to-cart forms. Framework agnostic.
- Markets (hydrogen-markets): Guide for implementing Shopify Markets with Hydrogen. Use when adding market routing, country/language localization, Shopify Markets, subdomains, per-market domains, path-prefixed markets, defineShopifyI18n, LocaleProvider, locale switchers, hreflang links, the <html lang> attribute, Next.js App Router market routing, or Storefront API @inContext wiring.
- Customer Account API (hydrogen-customer-account): Customer Account API setup for Hydrogen storefronts. Use when wiring customer sessions, login/logout/OAuth route handlers, account profile, order history, account-gated UI, cart buyer identity sync, or Customer Account GraphQL queries.
- Hydrogen Predictive Search (hydrogen-predictive-search): Guide for building predictive search with @shopify/hydrogen. Use when adding, modifying, or reviewing autocomplete/search-as-you-type UI, predictive search route handlers, tracking URLs, custom predictive search fragments, or framework predictive search bindings.
- Making A Hydrogen App Oxygen-Compatible (hydrogen-oxygen): Audit and adapt an existing Hydrogen storefront for Shopify Oxygen and local MiniOxygen. Use when asked to make a server-capable Hydrogen project Oxygen-compatible, add or repair its Worker server entrypoint, configure MiniOxygen, remove Node runtime assumptions, wire Worker environment, cache, and waitUntil, or verify dev, preview, and deploy behavior.
- Hydrogen Storefront Smoke Tests (hydrogen-smoke-test): Smoke-test checklist for Hydrogen storefronts built by agents. Use after creating or modifying a Hydrogen storefront, setup flow, cart, product page, collection/search browsing, analytics, request handlers, Shopify redirects, robots.txt, Shop Pay, or framework middleware integration.
- Migrate to Hydrogen 2026-10 (migrate-to-hydrogen-2026-10): Migrate a classic Hydrogen storefront (Remix or React Router 7) to Hydrogen 2026-10 (`@shopify/hydrogen@^2026.10.0`), where Hydrogen is a server-handler library you compose instead of a framework that owns the request. Use when the user asks to migrate or upgrade a Hydrogen storefront to Hydrogen 2026-10 ("migrate to hydrogen 2026-10", "migrate to hydrogen preview", "upgrade Hydrogen to the new library").
MCP servers
- Shopify Dev: Shopify's dev server: searches Shopify docs and API schemas and validates code; telemetry turned off. Needs Node.js, no account.
Install
claude plugin marketplace add Fcakiroglu16/marketplace claude plugin install shopify-hydrogen@playbookrun