shopify-partner — скилл для Codex: что делает и как установить
Помогает составлять GraphQL-запросы к Shopify Partner API для работы с приложениями и темами. Для запуска скриптов нужен Node.js.
npx skills add openai/plugins --skill shopify-partner -a codexЧто делает shopify-partner
Скилл настраивает агента на создание GraphQL-операций для Partner Dashboard. С его помощью запрашивают метрики приложений, статусы тем или данные по партнёрским выплатам. Для доступа требуется авторизация уровня партнёра, а не отдельного магазина.
Перед выдачей ответа ассистент обязан вызвать два локальных скрипта через bash. Сначала scripts/search_docs.mjs находит типы в документации. Затем scripts/validate.mjs проверяет полученный код. При ошибке валидации запускается цикл исправлений до трёх попыток.
Для работы окружению необходим Node.js. Скрипты передают телеметрию на shopify.dev/mcp/usage. Если отправку данных нужно заблокировать, задайте переменную OPT_OUT_INSTRUMENTATION=true.
Какие задачи решает
- Составить GraphQL-запрос к Partner API для каталога приложений
- Проверить типы полей через встроенный скрипт валидации
- Запросить историю транзакций и выплат партнёра по датам
- Собрать аналитику по реферальным комиссиям
Примеры запросов агенту
- Напиши GraphQL-запрос к Partner API для получения списка установок приложения
- Составь мутацию для публикации новой версии темы в кабинете партнёра
- Покажи транзакции и выплаты за прошлый месяц через Partner API
Как установить shopify-partner
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill shopify-partner -a codex2Вручную: положить файлы
.agents/skills/shopify-partner/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill shopify-partner -a claude-code2Вручную: положить файлы
~/.claude/skills/shopify-partner/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/shopify-partner/
Вручную: положить файлы
.cursor/skills/shopify-partner/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install openai/plugins shopify-partner2Вручную: положить файлы
.github/skills/shopify-partner/SKILL.mdКомандой платформы
gemini skills install https://github.com/openai/plugins --path plugins/shopify/skills/shopify-partnerВручную: положить файлы
.devin/skills/shopify-partner/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Скиллы Codex: как установить, где лежат и как вызвать
Вопросы о shopify-partner
Как установить shopify-partner в Codex?
Выполните npx skills add openai/plugins --skill shopify-partner -a codex. Файл скилла запишется в .agents/skills/shopify-partner/SKILL.md.
Что делает скилл shopify-partner?
Он ищет типы в документации Partner API и валидирует сгенерированный GraphQL-код перед отправкой пользователю.
Как отключить отправку телеметрии в Shopify?
Задайте переменную окружения OPT_OUT_INSTRUMENTATION=true перед запуском скриптов.
