vtex-io-client-integration — скилл для Claude Code: обзор и установка
Помогает настроить интеграцию бэкенда VTEX IO с внутренними сервисами и сторонними API. Пригодится при создании клиентов в node/clients/ и отказе от прямых вызовов fetch или axios.
npx skills add vtex/skills --skill vtex-io-client-integration -a claude-codeЧто делает vtex-io-client-integration
Скилл задаёт правила работы с сетевыми вызовами в серверных приложениях VTEX IO. Он помогает выбрать подходящий класс: готовые решения из @vtex/api и @vtex/clients для чекаута или каталога, ExternalClient для сторонних сервисов и JanusClient для обращений к Core Commerce. Все клиенты регистрируются в классе Clients внутри node/clients/index.ts. В обработчиках создавать экземпляры вручную нельзя. Запросы выполняются только через контекст ctx.clients.
Прямые сетевые запросы через axios, fetch или got в среде VTEX IO запрещены: они ломают сквозную телеметрию платформы и контекст авторизации. Навык требует оформлять сетевой транспорт отдельными классами и централизованно настраивать InstanceOptions. Туда входят таймауты от 1000 до 3000 мс, повторы для идемпотентных операций и сбор метрик.
Скилл сфокусирован только на транспортном слое. Инструкции не затрагивают разметку интерфейсов, GraphQL-схемы, права доступа к роутам и конфигурации в manifest.json или service.json.
Какие задачи решает
- заменить прямые вызовы
axiosиfetchна клиенты VTEX IO - написать кастомный клиент для внешнего API через
ExternalClient - зарегистрировать интеграции в
IOClientsдля доступа черезctx.clients - сконфигурировать
InstanceOptionsс таймаутами и повторами запросов - подключить нативные клиенты каталога и чекаута из
@vtex/clients
Примеры запросов агенту
- Создай класс клиента в
node/clients/для внешнего погодного API и зарегистрируй его вIOClients - Проверь бэкенд и перепиши прямые вызовы
fetchна клиенты из@vtex/api - Настрой
InstanceOptionsдля клиента заказов с таймаутом 2000 мс и двумя повторами
Как установить vtex-io-client-integration
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-client-integration -a claude-code2Вручную: положить файлы
~/.claude/skills/vtex-io-client-integration/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/vtex-io-client-integration/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-client-integration -a codex2Вручную: положить файлы
.agents/skills/vtex-io-client-integration/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-client-integration -a cursor2Вручную: положить файлы
.cursor/skills/vtex-io-client-integration/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install vtex/skills vtex-io-client-integration2Вручную: положить файлы
.github/skills/vtex-io-client-integration/SKILL.md1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-client-integration -a gemini-cli2Командой платформы
gemini skills install https://github.com/vtex/skills --path skills/vtex-io-client-integrationВручную: положить файлы
.devin/skills/vtex-io-client-integration/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-client-integration -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о vtex-io-client-integration
Как установить vtex-io-client-integration в Claude Code?
Выполните в терминале команду npx skills add vtex/skills --skill vtex-io-client-integration -a claude-code. Инструкции запишутся в файл ~/.claude/skills/vtex-io-client-integration/SKILL.md.
Зачем нужен скилл vtex-io-client-integration?
Он помогает выстроить архитектуру сетевых клиентов в VTEX IO, задействовать контекст ctx.clients и избавиться от нескоординированных HTTP-библиотек вроде axios.
Поможет ли скилл настроить manifest.json или GraphQL?
Нет, правила скилла исключают работу со схемами GraphQL, авторизацией роутов и манифестами manifest.json или service.json. Навык отвечает только за сетевые клиенты.
