vtex-io-application-performance — Claude Code skill for VTEX IO
Guides performance work on VTEX IO Node and .NET services, including cache choices, parallel client calls, and avoiding repeated work.
npx skills add vtex/skills --skill vtex-io-application-performance -a claude-codeWhat vtex-io-application-performance does
This skill covers application-level performance patterns for VTEX IO services. It helps choose between an in-process LRU and VBase, refresh stale values in the background, load AppSettings at startup or on a TTL, and run independent client calls concurrently. Payment responses and live transaction state must stay out of caches.
It also addresses outbound timeouts, passing ctx.clients.vbase into client helpers, and request-level deduplication with ctx.state. Include account and workspace in in-memory cache keys when one pod serves multiple tenants, or their data can collide. This skill does not cover public-path choices or CDN Cache-Control settings.
What it helps with
- choose between LRU and VBase for cached data
- load AppSettings without fetching them on every request
- run independent client calls concurrently
- remove duplicate calls in a resolver chain
- set timeouts for outbound requests
Example prompts for the agent
- Review this VTEX IO service for repeated client calls and suggest where
ctx.statefits. - Find independent calls in this resolver that can run concurrently.
- Compare LRU and VBase for these values, accounting for account and workspace in cache keys.
How to install vtex-io-application-performance
1Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-application-performance -a claude-code2Manually: put the files in place
~/.claude/skills/vtex-io-application-performance/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/vtex-io-application-performance/
1Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-application-performance -a codex2Manually: put the files in place
.agents/skills/vtex-io-application-performance/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-application-performance -a cursor2Manually: put the files in place
.cursor/skills/vtex-io-application-performance/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install vtex/skills vtex-io-application-performance2Manually: put the files in place
.github/skills/vtex-io-application-performance/SKILL.md1Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-application-performance -a gemini-cli2Platform CLI
gemini skills install https://github.com/vtex/skills --path skills/vtex-io-application-performanceManually: put the files in place
.devin/skills/vtex-io-application-performance/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-application-performance -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about vtex-io-application-performance
How do I install vtex-io-application-performance in Claude Code?
Run npx skills add vtex/skills --skill vtex-io-application-performance -a claude-code. The skill file will be at ~/.claude/skills/vtex-io-application-performance/SKILL.md.
What does vtex-io-application-performance do?
It guides performance and resilience work on VTEX IO Node and .NET services, with advice on caching, parallel calls, configuration loading, and request deduplication.
Can I cache active transaction data?
Keep payment results and live transaction state out of caches. For order forms, cart simulations, and session state, the skill discusses short-lived caching only when brief staleness is acceptable.