vtex-io-client-integration

SKILL.md

Client Integration & Service Access

When this skill applies

Use this skill when the main decision is how a VTEX IO backend app should call VTEX services or external APIs through the VTEX IO client system.

Creating custom clients under node/clients/

Choosing between native clients from @vtex/api or @vtex/clients and a custom client

Registering clients in IOClients and exposing them through ctx.clients

Configuring InstanceOptions such as retries, timeout, headers, or caching

Reviewing backend integrations that currently use raw HTTP libraries

Do not use this skill for:

deciding the app contract in manifest.json

structuring node/index.ts or tuning service.json

designing GraphQL schema or resolver contracts

modeling route authorization or security permissions

building storefront or admin frontend integrations