vtex-io-masterdata — скилл для Claude Code: Master Data v2 в VTEX IO
Помогает решить, стоит ли вообще хранить данные в Master Data, и если да — как вести сущности, схемы и CRUD в VTEX IO.
npx skills add vtex/skills --skill vtex-io-masterdata -a claude-codeЧто делает vtex-io-masterdata
Скилл включается, когда в приложении VTEX IO появляется своя персистентность: отзывы, вишлисты, отправки форм, записи конфигурации. Он не бросается писать код, а сначала заставляет проверить выбор хранилища. Данные о товарах и SKU логичнее держать в Catalog, заказы — в OMS, а внешняя база подойдёт, если документная модель Master Data не подходит под нагрузку.
Дальше — практика. Описание сущностей и JSON Schema через билдер masterdata, операции через ctx.clients.masterdata, поиск и scroll, триггеры на изменения, жизненный цикл схем. Синхронные чтения и записи в Master Data на пути покупки — корзина, оплата, оформление заказа — скилл разбирает отдельно: без оценки задержек и отказов ставить их туда не советует. Доступ из витрины или от партнёров идёт через сервис с аутентификацией и лимитами, а не напрямую в хранилище.
Есть и хозяйственная часть: аудит уже созданных сущностей, подсчёт документов через заголовки REST-Content-Range, массовые импорты через .jsonl с чекпоинтами и повторами при HTTP 429, лимит в 60 схем. Логи приложения место в логгере, кеш — в VBase, и скилл об этом напоминает.
Какие задачи решает
- понять, нужна ли вообще своя сущность в Master Data или хватит Catalog и спецификаций
- описать JSON Schema и не упереться в лимит схем
- убрать синхронные обращения к Master Data из корзины и оформления заказа
- загрузить десятки тысяч документов, не словив 429 и не начиная заново
- развести логи, кеш и бизнес-данные по правильным хранилищам
Примеры запросов агенту
- Проверь по vtex-io-masterdata, можно ли хранить отзывы в Master Data или лучше Catalog
- Опиши сущность и JSON Schema для вишлиста через билдер masterdata
- Настрой scrollDocuments и пагинацию для сущности с большим числом документов
Как установить vtex-io-masterdata
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-masterdata -a claude-code2Вручную: положить файлы
~/.claude/skills/vtex-io-masterdata/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/vtex-io-masterdata/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-masterdata -a codex2Вручную: положить файлы
.agents/skills/vtex-io-masterdata/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-masterdata -a cursor2Вручную: положить файлы
.cursor/skills/vtex-io-masterdata/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install vtex/skills vtex-io-masterdata2Вручную: положить файлы
.github/skills/vtex-io-masterdata/SKILL.md1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-masterdata -a gemini-cli2Командой платформы
gemini skills install https://github.com/vtex/skills --path skills/vtex-io-masterdataВручную: положить файлы
.devin/skills/vtex-io-masterdata/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-masterdata -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о vtex-io-masterdata
Как установить vtex-io-masterdata в Claude?
Выполните npx skills add vtex/skills --skill vtex-io-masterdata -a claude-code. После этого файл скилла лежит в ~/.claude/skills/vtex-io-masterdata/SKILL.md.
Что делает vtex-io-masterdata?
Помогает работать с Master Data v2 в приложениях VTEX IO: сущности, схемы, CRUD через MasterDataClient, поиск, триггеры. И заодно проверяет, подходит ли Master Data как хранилище для конкретной задачи.
Чем этот скилл отличается от скиллов по сервисам и GraphQL?
Он про персистентность в Master Data. Общие паттерны бэкенд-сервисов разбирает vtex-io-service-apps, схемы GraphQL — vtex-io-graphql-api, манифест и билдеры — vtex-io-app-structure.
