shopify-hydrogen — Codex skill: what it does, how to install
shopify-hydrogen — a skill for building Hydrogen storefronts with ready-made recipes: B2B commerce, bundles, Google Tag Manager integration, subscriptions, API query caching.
no license 1 installs ★ 8,052 updated 2026-10-08
npx skills add openai/plugins --skill shopify-hydrogen -a codexWhat shopify-hydrogen does
The skill provides access to the Hydrogen cookbook — a set of recipes for typical storefront tasks: combined listings, custom cart logic, dynamic content via metaobjects, infinite scroll, Partytown with GTM. Every request runs through documentation search (search_docs.mjs), then validates code (validate.mjs) before returning it. Requires Node.js to run.
Inside: TypeScript definitions for Hydrogen components (Image, Video, Money, MediaFile), utilities for Storefront API, and caching instructions. The skill distinguishes React components (api:"hydrogen") from GraphQL types (api:"storefront") to keep rendering separate from data fetching.
Validation is mandatory before every response. If validation fails, the skill searches for the error type, fixes the code, and re-validates — up to three retries. Code that has not passed validation is never returned.
What it helps with
- set up B2B sales in a Hydrogen storefront
- add infinite scroll to product listings
- integrate Google Tag Manager via Partytown
- cache third-party API queries
- build custom cart logic
Example prompts for the agent
- Build product bundles in Hydrogen using the cookbook recipe
- Add subscriptions to the storefront with the ready-made Hydrogen recipe
- Set up GTM with Partytown for a Hydrogen store
How to install shopify-hydrogen
1Skills CLI (Vercel)
npx skills add openai/plugins --skill shopify-hydrogen -a codex2Manually: put the files in place
.agents/skills/shopify-hydrogen/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add openai/plugins --skill shopify-hydrogen -a claude-code2Manually: put the files in place
~/.claude/skills/shopify-hydrogen/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/shopify-hydrogen/
1Skills CLI (Vercel)
npx skills add openai/plugins --skill shopify-hydrogen -a cursor2Manually: put the files in place
.cursor/skills/shopify-hydrogen/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install openai/plugins plugins/shopify/skills/shopify-hydrogen2Manually: put the files in place
.github/skills/shopify-hydrogen/SKILL.md1Skills CLI (Vercel)
npx skills add openai/plugins --skill shopify-hydrogen -a gemini-cli2Platform CLI
gemini skills install https://github.com/openai/plugins --path plugins/shopify/skills/shopify-hydrogenManually: put the files in place
.devin/skills/shopify-hydrogen/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: Codex skills: how to install, where they live, how to call them
Questions about shopify-hydrogen
How to install shopify-hydrogen in Codex?
Run npx skills add openai/plugins --skill shopify-hydrogen or npx skills add openai/plugins --skill shopify-hydrogen -a codex, the skill file will appear at .agents/skills/shopify-hydrogen/SKILL.md.
What does the shopify-hydrogen skill do?
Gives the agent ready-to-use recipes for Hydrogen storefronts: B2B, bundles, integrations, subscriptions, custom cart. Searches documentation and validates code via validate.mjs before every response.
What does shopify-hydrogen require to work?
Node.js. The skill only runs in an environment with Node.js installed, because it executes search and validation scripts.