Apply when defining service.json routes, choosing public vs segment vs private URL prefixes for VTEX IO services, or setting HTTP cache headers that interact…
VTEX IO service paths and CDN behavior When this skill applies Use this skill when you define or change service.json routes for a VTEX IO backend and need the edge (CDN) to pass the right cookies and apply the right caching for that endpoint’s data. Choosing between public, segment (/_v/segment/...), and private (/_v/private/...) path prefixes for a route Setting Cache-Control (and related headers) on HTTP responses so public cache behavior matches data scope (anonymous vs segment vs authenticated shopper) Explaining why a route does not receive vtex_session or vtex_segment cookies Troubleshooting CloudFront or edge behavior when cookies are missing (see official troubleshooting) Do not use this skill for: Application-level LRU caches, VBase, or stale-while-revalidate orchestration → use vtex-io-application-performance GraphQL field-level @cacheControl only → use vtex-io-graphql-api alongside this skill Decision rules
don't have the plugin yet? install it then click "run inline in claude" again.