vtex-io-rootpath — скилл для Claude Code: rootPath в VTEX IO
Скилл для VTEX IO-приложений в мультибиблиотечных магазинах: подсказывает, как строить URL с учётом префикса привязки. Пригодится при отладке 404 и битых ссылок.
npx skills add vtex/skills --skill vtex-io-rootpath -a claude-codeЧто делает vtex-io-rootpath
Скилл описывает работу с rootPath в магазинах VTEX IO, где несколько привязок делят один домен через префиксы пути (store.com/us/, store.com/br/). Он покрывает извлечение rootPath из заголовка x-vtex-root-path, хук useRuntime().rootPath в React, построение URL в бэкенде, генерацию ссылок и пути к ассетам.
Внутри — правила решений и жёсткие ограничения. Для бэкенда на Node нужен ранний middleware (обычно prepare), который читает заголовок, нормализует значение и кладёт его в ctx.state.rootPath; он же выставляет Vary: x-vtex-root-path, чтобы CDN кэшировал ответы по привязке. Для React — хук из vtex.render-runtime. Отдельное требование: санитизировать rootPath, потому что при значении "/" конкатенация даёт двойной слэш (//product/shoes), а это ломает канонические URL и приводит к циклам редиректов.
Скилл не для магазинов с одним доменом на локаль и не для общих паттернов бэкенда IO. Если префикс пути захардкожен как /us/, код сломается на других привязках — это и есть главный сценарий, который скилл закрывает.
Какие задачи решает
- собрать канонические URL с префиксом привязки
- починить 404 и битые ссылки в мультибиблиотечном магазине
- настроить middleware
prepareдля чтенияx-vtex-root-path - убрать двойные слэши при
rootPath === "/" - сгенерировать записи sitemap для каждой привязки
Примеры запросов агенту
- Покажи, как в middleware
prepareпрочитатьx-vtex-root-pathи положить вctx.state.rootPath. - Собери канонический URL товара с учётом
rootPathдля бэкенда VTEX IO. - Как получить
rootPathв React-компоненте черезuseRuntime()?
Как установить vtex-io-rootpath
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-rootpath -a claude-code2Вручную: положить файлы
~/.claude/skills/vtex-io-rootpath/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/vtex-io-rootpath/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-rootpath -a codex2Вручную: положить файлы
.agents/skills/vtex-io-rootpath/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-rootpath -a cursor2Вручную: положить файлы
.cursor/skills/vtex-io-rootpath/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install vtex/skills vtex-io-rootpath2Вручную: положить файлы
.github/skills/vtex-io-rootpath/SKILL.md1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-rootpath -a gemini-cli2Командой платформы
gemini skills install https://github.com/vtex/skills --path skills/vtex-io-rootpathВручную: положить файлы
.devin/skills/vtex-io-rootpath/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-rootpath -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о vtex-io-rootpath
Как установить vtex-io-rootpath в Claude Code?
Выполните npx skills add vtex/skills --skill vtex-io-rootpath -a claude-code. Скилл появится в ~/.claude/skills/vtex-io-rootpath/SKILL.md.
Что делает vtex-io-rootpath?
Описывает, как строить URL, ссылки, редиректы и пути к ассетам с префиксом привязки в мультибиблиотечных магазинах VTEX IO. Покрывает и бэкенд на Node, и React-фронтенд.
Для каких магазинов скилл не нужен?
Для магазинов с одним доменом на локаль, где префикс пути не используется. Также он не заменяет общие паттерны бэкенда IO и настройку CDN.
