vtex-io-app-contract — скилл для Claude Code
Помогает описывать контракт VTEX IO-приложения через manifest.json, builders и зависимости. Нужен при создании, разделении и публикации приложений.
npx skills add vtex/skills --skill vtex-io-app-contract -a claude-codeЧто делает vtex-io-app-contract
Скилл разбирает контракт VTEX IO-приложения: идентичность через vendor, name и version, объявления builders, dependencies, peerDependencies и billingOptions. Он помогает связать заявленные возможности с тем, что приложение действительно поставляет.
Правила подсказывают, когда добавить builder для node, graphql, react, admin, store, messages, pixel или masterdata, а когда вынести возможность в отдельное приложение. Также скилл помогает искать причины ошибок link и publish на уровне манифеста.
Если приложение содержит backend или GraphQL, но соответствующий builder не объявлен в manifest.json, контракт будет неполным, а платформа проигнорирует эту возможность.
Какие задачи решает
- описать контракт VTEX IO-приложения в
manifest.json - подобрать builders под фактические возможности приложения
- разделить
dependenciesиpeerDependencies - найти причину ошибки link или publish
- проверить идентичность и версию перед публикацией
Примеры запросов агенту
- Проверь
manifest.jsonнового VTEX IO-приложения и предложи нужные builders. - Определи, что вынести в отдельное приложение, если манифест содержит несвязанные возможности.
- Разбери ошибку publish и проверь
dependencies,peerDependencies,billingOptionsи версию приложения.
Как установить vtex-io-app-contract
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-app-contract -a claude-code2Вручную: положить файлы
~/.claude/skills/vtex-io-app-contract/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/vtex-io-app-contract/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-app-contract -a codex2Вручную: положить файлы
.agents/skills/vtex-io-app-contract/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-app-contract -a cursor2Вручную: положить файлы
.cursor/skills/vtex-io-app-contract/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install vtex/skills vtex-io-app-contract2Вручную: положить файлы
.github/skills/vtex-io-app-contract/SKILL.md1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-app-contract -a gemini-cli2Командой платформы
gemini skills install https://github.com/vtex/skills --path skills/vtex-io-app-contractВручную: положить файлы
.devin/skills/vtex-io-app-contract/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-app-contract -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о vtex-io-app-contract
Как установить vtex-io-app-contract в Claude Code?
Выполните npx skills add vtex/skills --skill vtex-io-app-contract -a claude-code, затем проверьте файл ~/.claude/skills/vtex-io-app-contract/SKILL.md.
Что делает vtex-io-app-contract?
Скилл помогает определить контракт VTEX IO-приложения через manifest.json: builders, зависимости, идентичность и коммерческие параметры.
Когда использовать dependencies, а когда peerDependencies?
dependencies подходят для приложений, которые можно автоматически установить вместе с текущим. peerDependencies нужны для внешне управляемых приложений и приложений с billingOptions.
