Real file from a public repo · synced Aug 22, 2026
vtex-io-storefront-theme-versioning
Apply when installing, publishing, upgrading, or rolling back a VTEX IO storefront theme app (vendor.store-theme or any app that owns store/blocks.json, store/routes.json, and store/contentSchemas.json). Covers how Site Editor and theme content are scoped by the app's MAJOR version, why a major version bump leaves the new major with no merchant content and silently falls back to default theme content, the safe install-in-workspace, migrate- content with the updateThemeIds mutation, smoke-test, then promote workflow, the 3-way mine-wins merge that vtex workspace promote performs against vtex.pages-graphql VBase (with automatic per-minute userData_backup snapshots when conflicts are resolved), and the support-led recovery path. Use for any operation that changes which version of a content-holding app is installed in master.
Works with
Install in three steps
- 1
Download the ZIP
One file per agent, plus INSTALL.md with the exact paths below.
- 2
Claude Code: copy SKILL.md into your skills folder
.claude/skills/vtex-io-storefront-theme-versioning/SKILL.md # this project ~/.claude/skills/vtex-io-storefront-theme-versioning/SKILL.md # every project
- 3
Other agents: use the matching file
skill.mdc goes in Cursor’s .cursor/rules/. AGENTS.md works as GitHub Copilot instructions, a legacy .cursorrules, or a Codex / Gemini CLI instructions file.

