Skip to main content
skill CX Codex

masterdata-storage-strategy — Claude Code skill: how to install

Guides data architecture decisions in VTEX, helping configure Master Data JSON schemas with indexing, security, and caching rules before creating entities.

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

What masterdata-storage-strategy does

The skill establishes architectural rules for VTEX storage. It evaluates whether a workload belongs in Master Data or requires Catalog, OMS, VBase, or an external database. Master Data cannot sustain sub-10ms response times, so placing it in checkout or payment critical paths will hurt conversion rates.

Guidance covers VTEX-specific schema extensions, including v-indexed, v-cache, v-default-fields, and v-security. Only query filter fields belong in v-indexed. Every secondary index forces updates on every write, driving up latency and consuming storage.

Implementation code for VTEX IO clients is out of scope here; other repository skills handle client integration.

What it helps with

  • select between Master Data, VBase, Catalog, and external SQL storage
  • configure JSON schemas using v-indexed and v-security
  • determine caching behavior via v-cache for high-write entities
  • audit existing entity schemas to remove unnecessary secondary indexes

Example prompts for the agent

  • Evaluate whether Master Data or VBase is better for storing user session flags
  • Design a JSON Schema with v-indexed and v-security for a product wishlist entity
  • Check if my schema indexes too many fields for write-heavy workloads

How to install masterdata-storage-strategy

1Skills CLI (Vercel)

npx skills add vtex/skills --skill masterdata-storage-strategy -a claude-code

2Manually: put the files in place

~/.claude/skills/masterdata-storage-strategy/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/masterdata-storage-strategy/

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

Questions about masterdata-storage-strategy

How do I install masterdata-storage-strategy in Claude Code?

Run npx skills add vtex/skills --skill masterdata-storage-strategy -a claude-code. The skill file will be placed at ~/.claude/skills/masterdata-storage-strategy/SKILL.md.

What does this skill help with?

It guides schema design and storage choices in VTEX, preventing over-indexing and misuse of Master Data for checkout-critical flows.

When should you avoid VTEX Master Data?

Avoid Master Data for relational data requiring joins, high-throughput time-series records, or checkout paths where sub-10ms latency is mandatory.

Similar skills

All skills for Backend and APIs →

From the same set43

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 payment-pci-security Enforces PCI DSS requirements and Secure Proxy routing when building payment connectors that handle card authorization, token exchange, and post-auth requests. CX Codex +1 1,000installs payment-provider-framework This skill guides VTEX IO payment connector work, from PPF wiring to Secure Proxy and build checks. Use it when implementing or maintaining a connector app. CX Codex +1 979installs sales-app-extensibility Guides the creation, styling, and deployment of VTEX Sales App extensions. Works through a seven-stage sequence from project checks to final delivery. CX Codex +1 856installs vtex-io-storefront-theme-versioning Guides coding agents through publishing, updating, or rolling back VTEX IO storefront themes without losing merchant Site Editor data across major versions. CX Codex +1 777installs vtex-io-rootpath A skill for VTEX IO apps in multi-binding stores: shows how to build URLs with the binding's path prefix. Useful when links 404 or point to the wrong locale. CX Codex +1 740installs 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

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