vtex-io-messages-and-i18n — скилл для Claude Code: локализация VTEX IO
Помогает вынести пользовательские строки в messages-инфраструктуру VTEX IO вместо хардкода в JSX и резолверах.
npx skills add vtex/skills --skill vtex-io-messages-and-i18n -a claude-codeЧто делает vtex-io-messages-and-i18n
Скилл включается, когда в приложении VTEX IO нужно перевести интерфейсные тексты, а не оставить их прямо в коде. Он разбирает работу с билдером messages, файлами /messages/*.json и context.json, подсказывает, как использовать сообщения во фронтенде и как связать переводы приложения с vtex.messages для перевода во время выполнения.
Внутри — правила решений и жёсткие ограничения. Ключи сообщений должны быть привязаны к приложению и описаны явно, а не придумываться по ходу в коде. Для витрины советует префикс store/..., для админки и Site Editor — admin/.... В context.json ключи лежат плоской картой messageId -> description. В бэкенде и GraphQL переводить стоит только там, где граница приложения действительно требует локализованного текста.
Файлы переводов — не место для конфигурации. Если в них попадают URL API, учётные данные или бизнес-правила, скилл останавливает и просит перенести это в настройки приложения. Полный en.json держите как запасной вариант, даже если основная аудитория говорит на другом языке: так у системы есть стабильная база для разрешения сообщений.
Какие задачи решает
- вынести подписи кнопок и заголовки из JSX в файлы переводов
- завести ключи сообщений в
context.jsonбез дублей - разделить ключи витрины и админки по префиксам
- убрать из message-файлов конфигурацию и секреты
- подключить переводы приложения к
vtex.messages
Примеры запросов агенту
- Проверь, что все пользовательские строки в этом компоненте берутся из messages, а не зашиты в JSX
- Добавь ключ
admin/my-app.saveвcontext.jsonи вen.json - Посмотри резолверы и скажи, где перевод нужен на границе приложения, а где достаточно вернуть данные
Как установить vtex-io-messages-and-i18n
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-messages-and-i18n -a claude-code2Вручную: положить файлы
~/.claude/skills/vtex-io-messages-and-i18n/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/vtex-io-messages-and-i18n/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-messages-and-i18n -a codex2Вручную: положить файлы
.agents/skills/vtex-io-messages-and-i18n/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-messages-and-i18n -a cursor2Вручную: положить файлы
.cursor/skills/vtex-io-messages-and-i18n/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install vtex/skills vtex-io-messages-and-i18n2Вручную: положить файлы
.github/skills/vtex-io-messages-and-i18n/SKILL.md1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-messages-and-i18n -a gemini-cli2Командой платформы
gemini skills install https://github.com/vtex/skills --path skills/vtex-io-messages-and-i18nВручную: положить файлы
.devin/skills/vtex-io-messages-and-i18n/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-messages-and-i18n -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о vtex-io-messages-and-i18n
Как установить vtex-io-messages-and-i18n в Claude Code?
Выполните npx skills add vtex/skills --skill vtex-io-messages-and-i18n -a claude-code. Файл скилла появится по пути ~/.claude/skills/vtex-io-messages-and-i18n/SKILL.md.
Что делает vtex-io-messages-and-i18n?
Помогает локализовать приложения VTEX IO через билдер messages: подсказывает структуру файлов переводов, правила именования ключей и работу с vtex.messages.
Можно ли хранить в message-файлах настройки приложения?
Нет. Скилл требует держать там только локализованный текст, а URL API, учётные данные и бизнес-правила переносить в настройки приложения или отдельный механизм.
