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