# vtex-io-data-access-patterns

Guides AI coding agents on picking the right storage layer across VTEX IO apps. It helps design read pipelines, caching strategies, and data boundaries.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1100 installs · ★ 46
- Author: vtex
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/vtex/skills/tree/HEAD/skills/vtex-io-data-access-patterns/SKILL.md
- Updated: 2026-10-14
- HTML: https://affpapa.org/en/nevibecode/skills/vtex-io-data-access-patterns

## What it does

This skill guides decisions on where data belongs across VTEX IO apps. It directs assistants to keep merchant toggles and base endpoints inside app settings. Storing arrays or operational state in `settingsSchema` is forbidden. Operational entities belong in `Master Data` or `VBase` instead.

VTEX platform APIs must remain the primary source of truth for orders and pricing. Local copies must stay strictly limited to lightweight derived attributes. Large reads must rely on database pagination and targeted field selection. Filtering full collections inside Node memory is blocked.

The rules do not cover granular Master Data schema modeling, auth tokens, or runtime sizing.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add vtex/skills --skill vtex-io-data-access-patterns -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/vtex-io-data-access-patterns/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/vtex-io-data-access-patterns/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add vtex/skills --skill vtex-io-data-access-patterns -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/vtex-io-data-access-patterns/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add vtex/skills --skill vtex-io-data-access-patterns -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/vtex-io-data-access-patterns/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install vtex/skills vtex-io-data-access-patterns
```

2. **Manually: put the files in place**
- File: `.github/skills/vtex-io-data-access-patterns/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add vtex/skills --skill vtex-io-data-access-patterns -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/vtex/skills --path skills/vtex-io-data-access-patterns
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/vtex-io-data-access-patterns/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add vtex/skills --skill vtex-io-data-access-patterns -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/vtex/skills/tree/HEAD/skills/vtex-io-data-access-patterns/SKILL.md

## When to use it
- pick between VBase, Master Data, and app settings
- remove operational transaction arrays from settingsSchema
- replace in-memory collection filtering with paginated database queries
- build lean cache representations without cloning core commerce models

## Example prompts
- Review this VTEX IO service to ensure operational data is not stored in app settings
- Decide whether we should use VBase or Master Data for storing temporary customer export snapshots
- Refactor this Master Data query to use server-side pagination instead of loading everything into memory

## Similar
- [mcp-builder](https://affpapa.org/en/nevibecode/skills/mcp-builder.md) — skill · 130949 installs
- [claude-api](https://affpapa.org/en/nevibecode/skills/claude-api.md) — skill · 74198 installs
- [lark-im](https://affpapa.org/en/nevibecode/skills/lark-im.md) — skill · 472900 installs
- [lark-event](https://affpapa.org/en/nevibecode/skills/lark-event.md) — skill · 466800 installs
- [caveman-discover](https://affpapa.org/en/nevibecode/skills/caveman-discover.md) — skill · 104400 installs
- [migration](https://affpapa.org/en/nevibecode/skills/migration.md) — skill · 103900 installs

From the same set: [vtex/skills](https://affpapa.org/en/nevibecode/by/vtex/skills.md) — 38 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md