# shopify-hydrogen

Скилл shopify-hydrogen для разработки витрин на Hydrogen с готовыми рецептами: B2B-коммерция, бандлы, интеграция Google Tag Manager, подписки, кеширование запросов.

- скилл · `type=skill` · Codex, ChatGPT, Claude Code, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · 1 установка · ★ 8052 у репозитория
- Автор: Shopify · официальный репозиторий OpenAI
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/openai/plugins/tree/HEAD/plugins/shopify/skills/shopify-hydrogen/SKILL.md
- Обновлён: 2026-10-08
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/shopify-hydrogen

## Что делает

Скилл даёт доступ к кукбуку Hydrogen — набору рецептов для типовых задач интернет-магазина: комбинированные листинги, кастомная корзина, динамический контент через метаобъекты, бесконечная прокрутка, интеграция Partytown с GTM. Каждый запрос скилл обрабатывает через поиск по документации (`search_docs.mjs`), затем валидирует код (`validate.mjs`) перед возвратом. Без Node.js не работает.

Внутри — TypeScript-определения компонентов Hydrogen (`Image`, `Video`, `Money`, `MediaFile`), утилиты для работы с Storefront API и инструкции по кешированию. Скилл различает React-компоненты (`api:"hydrogen"`) и GraphQL-типы (`api:"storefront"`), чтобы не путать рендеринг с запросами данных.

Скилл форсирует валидацию перед каждым ответом: если проверка не прошла, он перезапрашивает документацию по ошибке, исправляет код и валидирует заново, до трёх раз. Код без пройденной валидации агент не возвращает.

## Установка

### Codex (родная платформа)

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

2. **Вручную: положить файлы**
- Файл: `.agents/skills/shopify-hydrogen/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Claude Code

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

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/shopify-hydrogen/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/shopify-hydrogen/

### Cursor

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

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/shopify-hydrogen/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

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

2. **Вручную: положить файлы**
- Файл: `.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. **Командой платформы**
```bash
gemini skills install https://github.com/openai/plugins --path plugins/shopify/skills/shopify-hydrogen
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/shopify-hydrogen/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/openai/plugins/tree/HEAD/plugins/shopify/skills/shopify-hydrogen/SKILL.md

## Когда брать
- настроить B2B-продажи в Hydrogen-витрине
- добавить бесконечную прокрутку каталога
- интегрировать Google Tag Manager через Partytown
- закешировать запросы к внешнему API
- построить кастомную логику корзины

## Примеры запросов агенту
- Реализуй бандлы товаров в Hydrogen по рецепту из кукбука
- Добавь подписки в витрину, используй готовый рецепт Hydrogen
- Настрой интеграцию GTM с Partytown для Hydrogen-магазина

## Похожие
- [shopify-developer](https://affpapa.org/nevibecode/skills/shopify-developer.md) — скилл · ★ 7191 у репозитория
- [shopify](https://affpapa.org/nevibecode/skills/shopify.md) — скилл · 7700 установок
- [shopify-expert](https://affpapa.org/nevibecode/skills/shopify-expert.md) — скилл · 5400 установок
- [shopify-ai-toolkit](https://affpapa.org/nevibecode/plugins/shopify-ai-toolkit.md) — плагин · ★ 652 у репозитория
- [shopify-setup](https://affpapa.org/nevibecode/skills/shopify-setup.md) — скилл · 1300 установок
- [Shopify MCP](https://affpapa.org/nevibecode/mcp/shopify-mcp.md) — MCP-сервер · ★ 1 у репозитория

Из того же набора: [openai/plugins](https://affpapa.org/nevibecode/by/openai/plugins.md) — 567 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
