# shopify-hydrogen

shopify-hydrogen — a skill for building Hydrogen storefronts with ready-made recipes: B2B commerce, bundles, Google Tag Manager integration, subscriptions, API query caching.

- skill · `type=skill` · Codex, ChatGPT, Claude Code, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · 1 install · ★ 8052 repo stars
- Author: Shopify · official OpenAI repository
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/openai/plugins/tree/HEAD/plugins/shopify/skills/shopify-hydrogen/SKILL.md
- Updated: 2026-10-08
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/shopify-hydrogen

## What it 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.

## Install

### Codex (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add openai/plugins --skill shopify-hydrogen -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/shopify-hydrogen/SKILL.md` — For all projects use ~/.agents/skills/

### Claude Code

1. **Skills CLI (Vercel)**
```bash
npx skills add openai/plugins --skill shopify-hydrogen -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/shopify-hydrogen/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/shopify-hydrogen/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add openai/plugins --skill shopify-hydrogen -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/shopify-hydrogen/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install openai/plugins plugins/shopify/skills/shopify-hydrogen
```

2. **Manually: put the files in place**
- File: `.github/skills/shopify-hydrogen/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add openai/plugins --skill shopify-hydrogen -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/openai/plugins --path plugins/shopify/skills/shopify-hydrogen
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/shopify-hydrogen/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/openai/plugins/tree/HEAD/plugins/shopify/skills/shopify-hydrogen/SKILL.md

## When to use it
- 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
- 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

## Similar
- [shopify-developer](https://affpapa.org/en/nevibecode/skills/shopify-developer.md) — skill · ★ 7191 repo stars
- [shopify](https://affpapa.org/en/nevibecode/skills/shopify.md) — skill · 7700 installs
- [shopify-expert](https://affpapa.org/en/nevibecode/skills/shopify-expert.md) — skill · 5400 installs
- [shopify-ai-toolkit](https://affpapa.org/en/nevibecode/plugins/shopify-ai-toolkit.md) — plugin · ★ 652 repo stars
- [shopify-setup](https://affpapa.org/en/nevibecode/skills/shopify-setup.md) — skill · 1300 installs
- [Shopify MCP](https://affpapa.org/en/nevibecode/mcp/shopify-mcp.md) — MCP server · ★ 1 repo stars

From the same set: [openai/plugins](https://affpapa.org/en/nevibecode/by/openai/plugins.md) — 567 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
