vtex-io-service-configuration-apps — скилл для Claude Code
Скилл помогает разделять логику сервисов и настройки в VTEX IO с помощью билдера configuration. Пригодится при передаче единой схемы конфигурации между несколькими приложениями.
npx skills add vtex/skills --skill vtex-io-service-configuration-apps -a claude-codeЧто делает vtex-io-service-configuration-apps
Скилл задаёт архитектурные правила для вынесения настроек сервисов VTEX IO в отдельные приложения. Вместо хранения параметров в локальном settingsSchema конфигурация описывается схемой configuration/schema.json, а значения передаются через билдер configuration. Это позволяет обновлять конфиги независимо от кода бэкенда.
Внутри сервиса входящие параметры считываются напрямую из ctx.vtex.settings. Скилл требует строгого разделения ролей: приложение с настройками не должно объявлять билдеры node или graphql. Для приёма данных маршруты или события в node/service.json обязаны содержать флаг settingsType: "workspace", либо директиву @settings в схеме GraphQL.
Без явного указания settingsType среда исполнения проигнорирует внешние значения. Лишние HTTP-вызовы здесь запрещены. Если сервису не хватает прав на чтение данных воркспейса, в манифест добавляют политику read-workspace-apps.
Какие задачи решает
- отделить жизненный цикл конфигурации от релизов сервисного приложения
- связать маршруты в node/service.json с внешними настройками через settingsType: workspace
- описать контракт параметров в configuration/schema.json с валидацией через JSON Schema
- настроить чтение переданных параметров из контекста ctx.vtex.settings без лишних HTTP-запросов
Примеры запросов агенту
- Спроектируй конфигурационное приложение для сервиса shipping-service через билдер configuration.
- Добавь поддержку внешних настроек в маршруты node/service.json и валидацию ctx.vtex.settings.
- Составь configuration/schema.json с запретом лишних свойств для интеграции платёжного шлюза.
Как установить vtex-io-service-configuration-apps
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-service-configuration-apps -a claude-code2Вручную: положить файлы
~/.claude/skills/vtex-io-service-configuration-apps/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/vtex-io-service-configuration-apps/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-service-configuration-apps -a codex2Вручную: положить файлы
.agents/skills/vtex-io-service-configuration-apps/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-service-configuration-apps -a cursor2Вручную: положить файлы
.cursor/skills/vtex-io-service-configuration-apps/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install vtex/skills vtex-io-service-configuration-apps2Вручную: положить файлы
.github/skills/vtex-io-service-configuration-apps/SKILL.md1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-service-configuration-apps -a gemini-cli2Командой платформы
gemini skills install https://github.com/vtex/skills --path skills/vtex-io-service-configuration-appsВручную: положить файлы
.devin/skills/vtex-io-service-configuration-apps/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-service-configuration-apps -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о vtex-io-service-configuration-apps
Как установить vtex-io-service-configuration-apps в Claude Code?
Выполните команду npx skills add vtex/skills --skill vtex-io-service-configuration-apps -a claude-code.
Зачем разделять сервисное приложение и конфигурационное приложение в VTEX IO?
Такое разделение позволяет использовать один контракт настроек в нескольких сервисах и менять параметры без повторной сборки сервисного рантайма.
В каких случаях лучше использовать settingsSchema вместо конфигурационного приложения?
Используйте settingsSchema, если параметры привязаны к одному конкретному сервису и должны редактироваться вручную в панели управления через App Settings.
