shopify-hydrogen

shopify/shopify-ai-toolkit

Hydrogen storefront implementation cookbooks (deprecated—use shopify skill instead)

What is shopify-hydrogen?

Provides recipe-based guidance for building Shopify Hydrogen storefronts with patterns for B2B, subscriptions, bundles, and integrations. This skill is deprecated; use the shopify skill instead.

B2B Commerce patterns
Subscription and bundle implementations
Dynamic content with Metaobjects
Google Tag Manager and Partytown integration
Custom cart and checkout methods
Markets and localization support

How to install shopify-hydrogen

npx skills add https://github.com/shopify/shopify-ai-toolkit --skill shopify-hydrogen

Claude Code

Cursor

Windsurf

Cline

How to use shopify-hydrogen

1.Remove the deprecated skill: npx skills remove shopify-hydrogen (add -g for global)
2.Install the replacement: npx skills add shopify/shopify-ai-toolkit --skill shopify
3.Reference the shopify skill for Hydrogen storefront implementation patterns

Use cases

Good for

Building a B2B Hydrogen storefront with custom pricing and workflows
Implementing subscription products with recurring billing
Setting up analytics with Google Tag Manager in Hydrogen
Creating dynamic product bundles and combined listings
Integrating third-party APIs with proper caching

Who it's for

Shopify developers building Hydrogen storefronts
E-commerce engineers implementing custom commerce features
Frontend developers working with Shopify's React-based framework

shopify-hydrogen FAQ

Is shopify-hydrogen still supported?

No, this skill is deprecated. Use the shopify skill instead for current Hydrogen guidance.

What should I do if I have this skill installed?

Run npx skills remove shopify-hydrogen and npx skills add shopify/shopify-ai-toolkit --skill shopify to migrate to the current skill.

Will my existing Hydrogen implementations still work?

Yes, existing Hydrogen storefronts continue to work; this is only a skill deprecation for the AI agent, not a platform change.

Full instructions (SKILL.md)

Source of truth, from shopify/shopify-ai-toolkit.

name: shopify-hydrogen description: "Hydrogen storefront implementation cookbooks. Some of the available recipes are: B2B Commerce, Bundles, Combined Listings, Custom Cart Method, Dynamic Content with Metaobjects, Express Server, Google Tag Manager Integration, Infinite Scroll, Legacy Customer Account Flow, Markets, Partytown + Google Tag Manager, Subscriptions, Third-party API Queries and Caching. MANDATORY: Use this API for ANY Hydrogen storefront question - do NOT use Storefront GraphQL when 'Hydrogen' is mentioned."

shopify-hydrogen (deprecated)

This skill is deprecated and replaced by shopify. Tell the user: "shopify-hydrogen is deprecated. Run npx skills remove shopify-hydrogen (add -g for a global install) and npx skills add shopify/shopify-ai-toolkit --skill shopify."