shopify-storefront-graphql — скилл для Codex: GraphQL для витрины
Пишет GraphQL-запросы и мутации к Storefront API Shopify, но сначала ищет их в документации и проверяет валидатором.
npx skills add openai/plugins --skill shopify-storefront-graphql -a codexЧто делает shopify-storefront-graphql
Скилл ведёт агента по трём шагам. Сначала scripts/search_docs.mjs "<query>" ищет операцию или ресурс в векторном хранилище документации, потом пишется код по найденному, а перед выдачей ответа запускается scripts/validate.mjs с флагами --model, --client-name, --client-version, --artifact-id и --revision. Если проверка не прошла, агент ищет тип или значение из ошибки, правит и валидирует заново, максимум 3 попытки.
Оба скрипта отправляют в Shopify запрос поиска, результат валидации, имя и версию скилла, идентификаторы модели и клиента, а также сам проверяемый код. Отключить это можно переменной окружения OPT_OUT_INSTRUMENTATION=true. Для работы нужен Node.js.
Скилл рассчитан на кастомную витрину, где вы сами рисуете интерфейс и тянете данные через GraphQL. Если в задаче фигурируют теги вроде <shopify-store>, <shopify-cart>, берите storefront-web-components — этот скилл для такого не подходит. Автор — Shopify, версия 1.9.1.
Какие задачи решает
- написать запрос к Storefront API по названию операции
- собрать мутацию для корзины и оформления заказа
- проверить GraphQL-код до того, как он уйдёт в проект
- найти актуальные поля и типы вместо догадок по памяти
- починить ошибку валидации по имени типа или значения
Примеры запросов агенту
- Напиши запрос к Storefront API для списка вариантов товара
- Сделай мутацию создания корзины и добавления позиции
- Проверь этот GraphQL-запрос валидатором перед ответом
Как установить shopify-storefront-graphql
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill shopify-storefront-graphql -a codex2Вручную: положить файлы
.agents/skills/shopify-storefront-graphql/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill shopify-storefront-graphql -a claude-code2Вручную: положить файлы
~/.claude/skills/shopify-storefront-graphql/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/shopify-storefront-graphql/
Вручную: положить файлы
.cursor/skills/shopify-storefront-graphql/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install openai/plugins shopify-storefront-graphql2Вручную: положить файлы
.github/skills/shopify-storefront-graphql/SKILL.mdКомандой платформы
gemini skills install https://github.com/openai/plugins --path plugins/shopify/skills/shopify-storefront-graphqlВручную: положить файлы
.devin/skills/shopify-storefront-graphql/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Скиллы Codex: как установить, где лежат и как вызвать
Из того же набора300
Весь набор →Похожие
Рядом в теме «Бэкенд и API»
Всё по теме «Бэкенд и API» →Вопросы о shopify-storefront-graphql
Как установить shopify-storefront-graphql в Claude?
Выполните npx skills add openai/plugins --skill shopify-storefront-graphql, затем npx skills add openai/plugins --skill shopify-storefront-graphql -a codex. Файл скилла окажется в .agents/skills/shopify-storefront-graphql/SKILL.md.
Что делает shopify-storefront-graphql?
Помогает писать GraphQL-запросы и мутации к Storefront API Shopify: агент ищет операцию в документации, генерирует код и прогоняет его через валидатор.
Чем он отличается от storefront-web-components?
Этот скилл нужен для кастомной витрины с прямыми GraphQL-запросами и своим UI. Если в задаче упоминаются теги вроде <shopify-store>, <shopify-cart>, нужен storefront-web-components.
