Skip to main content
affpapa.org
RU EN
skill CX Codex

vtex-io-service-paths-and-cdn — Claude Code skill for routes and CDN

Picks the right path prefix in service.json and matches Cache-Control to the data, so edge caching does not serve one shopper's payload to another.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add vtex/skills --skill vtex-io-service-paths-and-cdn -a claude-code
Open on GitHub

What vtex-io-service-paths-and-cdn does

The skill walks through three prefix options for VTEX IO routes: public, /_v/segment/ and /_v/private/. The choice decides which cookies reach your service and whether VTEX caches the response at the edge. Public paths give no guarantee of request cookies, segment paths receive vtex_segment and cache per segment, private paths add vtex_session and skip edge caching entirely.

Inside are decision rules, a list of common failure modes and a review checklist. Classify the response first — anonymous, segment-scoped or authenticated — then assign the path and headers. A route returning order history, addresses or tokens on a public path with a long max-age leaks data between shoppers. One trap worth knowing: the path prefix and the "public": true field in service.json control different things, and they get mixed up often.

Field-level GraphQL caching lives in vtex-io-graphql-api; LRU, VBase and stale-while-revalidate belong to vtex-io-application-performance. This one stays on routes and response headers.

What it helps with

  • pick a path prefix that fits the data in the response
  • explain why a route never receives vtex_session
  • align Cache-Control with how sensitive the payload is
  • split public catalog and private account data into separate endpoints
  • catch personalized JSON being cached at the edge

Example prompts for the agent

  • Check the routes in service.json and flag any that return personal data on a public path
  • Help me choose between /_v/segment/ and /_v/private/ for an endpoint with region-based pricing
  • Review the Cache-Control headers against what these endpoints actually return

How to install vtex-io-service-paths-and-cdn

1Skills CLI (Vercel)

npx skills add vtex/skills --skill vtex-io-service-paths-and-cdn -a claude-code

2Manually: put the files in place

~/.claude/skills/vtex-io-service-paths-and-cdn/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/vtex-io-service-paths-and-cdn/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about vtex-io-service-paths-and-cdn

How do I install vtex-io-service-paths-and-cdn in Claude?

Run npx skills add vtex/skills --skill vtex-io-service-paths-and-cdn -a claude-code. The skill file lands at ~/.claude/skills/vtex-io-service-paths-and-cdn/SKILL.md.

What does vtex-io-service-paths-and-cdn do?

It covers VTEX IO path prefixes, how they relate to cookies and edge caching, and how to set Cache-Control to match the access level of the data.

How is it different from vtex-io-graphql-api?

This skill is about service.json routes and response headers. Field-level GraphQL caching with @cacheControl is handled by the other skill.

Similar skills

Everything for Backend and APIs →
cdn-caching official Vercel Labs Explains why a response came from cache or missed it: status headers, per-request reasons, revalidation, ISR cost. CX Codex GP ChatGPT 2installs setup-cdn-optimization davila7 A slash command that walks your agent through CDN configuration: caching, compression, image formats and cache invalidation. 218installs cdn-setup devops-skills Configures CloudFront and Cloudflare CDNs for static asset delivery, caching rules, and cache invalidation. Useful when deploying web apps and edge routing. CX Codex +1 324installs netlify-caching netlify Configures Netlify CDN caching for Functions, Edge Functions, and proxies. Helps with cache-control headers, key variation, and cache invalidation. CX Codex +1 3,100installs netlify-image-cdn netlify Guides your agent on transforming images on demand via Netlify Image CDN. Useful for responsive layouts and format conversion. CX Codex +1 3,000installs grpc-service-development aj-geddes This skill walks your agent through gRPC service work: Protocol Buffers contracts, four call patterns, servers in Node.js and Python. CX Codex +1 527installs

From the same set8

vtex-io-masterdata Walks you through Master Data v2 in VTEX IO apps and pushes back when the data belongs somewhere else. CX Codex +1 1,200installs payment-idempotency A skill for payment connector code that keeps Gateway retries from hitting the acquirer twice and charging the customer again. CX Codex +1 1,100installs vtex-io-auth-tokens-and-context Decides which VTEX IO token should back a backend request: the app itself, a shopper, or an Admin user. CX Codex +1 1,100installs vtex-io-http-routes Guides the design of HTTP endpoints in a VTEX IO backend service: route boundaries, middleware chains, request validation and response shape. CX Codex +1 1,100installs marketplace-rate-limiting Teaches your agent to handle VTEX API 429s: exponential backoff with jitter, rate limit headers, circuit breaker and request queuing. CX Codex +1 1,000installs payment-async-flow Rules for VTEX payment connector code: Boleto, Pix, bank redirects, callbackUrl handling and signature validation. CX Codex +1 1,000installs vtex-io-rbac Walks you through locking down VTEX IO app routes and resources: role policies, resource policies, VRN principals and @auth directives. CX Codex +1 737installs

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor