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