vtex-io-render-runtime-and-blocks — скилл для Claude Code: установка
Скилл учит агента подключать React-компоненты к Store Framework как блоки в VTEX IO: записи в store/interfaces.json, композиция и связь с темой.
npx skills add vtex/skills --skill vtex-io-render-runtime-and-blocks -a claude-codeЧто делает vtex-io-render-runtime-and-blocks
Скилл описывает, как компонент из react/ становится блоком, который тема видит в store/*.json. Каждый блок записывается в store/interfaces.json: ключ — это ID блока, а поле component указывает на точку входа, например ProductReviews или вложенный путь product/ProductReviews.
Для вложенных блоков есть composition. Значение children значит, что компонент сам рисует потомков через props.children. Значение blocks открывает именованные слоты, которыми управляет Store Framework. Список allowed ограничивает, какие блоки можно класть внутрь. Для простого блока composition не нужен.
Главная ловушка в версиях. ID блока привязан к мажорной версии приложения, которое его объявило. Если тема зависит от acme.product-widgets в 0.x, а блок появился только в 5.x, страница упадёт с ошибкой Missing block [email protected]:acme-related-products. Тогда агент должен остановиться и выровнять диапазон зависимости. Внутренности компонента, админку и бэкенд скилл не трогает.
Какие задачи решает
- зарегистрировать компонент
ProductReviewsкак блок вstore/interfaces.json - проверить, что
componentуказывает на существующий файл вreact/ - настроить вложенные блоки через
compositionиallowed - найти причину ошибки
Missing blockпосле смены зависимости темы - подключить готовый блок к странице через
blocksвstore/home.json
Примеры запросов агенту
- Зарегистрируй
ProductReviewsкак блок Store Framework вstore/interfaces.json - Проверь, что все блоки в
store/interfaces.jsonведут на реальные файлы вreact/ - Страница падает с
Missing block [email protected]:acme-related-products, разберись с версией блока
Как установить vtex-io-render-runtime-and-blocks
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-render-runtime-and-blocks -a claude-code2Вручную: положить файлы
~/.claude/skills/vtex-io-render-runtime-and-blocks/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/vtex-io-render-runtime-and-blocks/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-render-runtime-and-blocks -a codex2Вручную: положить файлы
.agents/skills/vtex-io-render-runtime-and-blocks/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-render-runtime-and-blocks -a cursor2Вручную: положить файлы
.cursor/skills/vtex-io-render-runtime-and-blocks/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install vtex/skills vtex-io-render-runtime-and-blocks2Вручную: положить файлы
.github/skills/vtex-io-render-runtime-and-blocks/SKILL.md1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-render-runtime-and-blocks -a gemini-cli2Командой платформы
gemini skills install https://github.com/vtex/skills --path skills/vtex-io-render-runtime-and-blocksВручную: положить файлы
.devin/skills/vtex-io-render-runtime-and-blocks/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-render-runtime-and-blocks -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о vtex-io-render-runtime-and-blocks
Как установить vtex-io-render-runtime-and-blocks в Claude Code?
Выполните npx skills add vtex/skills --skill vtex-io-render-runtime-and-blocks -a claude-code. Файл скилла окажется в ~/.claude/skills/vtex-io-render-runtime-and-blocks/SKILL.md.
Что делает vtex-io-render-runtime-and-blocks?
Помогает агенту подключать React-компоненты к Store Framework: вносит блоки в store/interfaces.json, сверяет component с файлами в react/ и настраивает composition и allowed.
Почему в VTEX IO появляется ошибка Missing block?
ID блока привязан к мажорной версии приложения, которое его объявило. Если тема зависит от 0.x, а блок добавили в 5.x, резолвер его не найдёт. Нужно поправить диапазон зависимости или перенести объявление блока.
