vtex-io-storefront-react — Claude Code skill: how to install
Guides coding of shopper-facing VTEX IO React components. Enforces vtex.css-handles, localized strings, and storefront hooks while preventing Node-only runtime calls.
npx skills add vtex/skills --skill vtex-io-storefront-react -a claude-codeWhat vtex-io-storefront-react does
This skill guides assistants building shopper-facing Store Framework interfaces inside the react/ directory. It enforces the vtex.css-handles contract so merchants can style blocks without modifying component markup. Direct, arbitrary class names in JSX are treated as defects. Customer-visible text must use message IDs rather than raw hardcoded strings.
Storefront components should stay lean and props-driven. Store state belongs in containers or hooks such as useProduct, useOrderForm, and useRuntime rather than ad hoc client-side API requests. Importing Node-only packages like fs or touching window without safety guards will break server-side rendering during page delivery. Accessible markup is also required, which rules out clickable div tags.
The skill strictly excludes backend services, GraphQL schemas, admin pages, and block registration contracts. Those areas rely on separate VTEX IO specifications.
What it helps with
- expose storefront component styles via vtex.css-handles
- retrieve store data through hooks like useProduct or useOrderForm
- block server-only Node.js imports inside browser components
- replace static JSX text with internationalization message IDs
- enforce accessible HTML tags instead of clickable div elements
Example prompts for the agent
- Build a storefront banner component in react/Banner.tsx using vtex.css-handles.
- Review our product card component to replace direct API calls with useProduct.
- Create a newsletter signup form with semantic buttons and i18n message IDs.
How to install vtex-io-storefront-react
1Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-storefront-react -a claude-code2Manually: put the files in place
~/.claude/skills/vtex-io-storefront-react/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/vtex-io-storefront-react/
1Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-storefront-react -a codex2Manually: put the files in place
.agents/skills/vtex-io-storefront-react/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-storefront-react -a cursor2Manually: put the files in place
.cursor/skills/vtex-io-storefront-react/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install vtex/skills vtex-io-storefront-react2Manually: put the files in place
.github/skills/vtex-io-storefront-react/SKILL.md1Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-storefront-react -a gemini-cli2Platform CLI
gemini skills install https://github.com/vtex/skills --path skills/vtex-io-storefront-reactManually: put the files in place
.devin/skills/vtex-io-storefront-react/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-storefront-react -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about vtex-io-storefront-react
How do I install vtex-io-storefront-react in Claude Code?
Run npx skills add vtex/skills --skill vtex-io-storefront-react -a claude-code in your project terminal.
What does vtex-io-storefront-react do?
It instructs coding assistants how to write and review shopper-facing Store Framework components. The skill mandates vtex.css-handles, enforces i18n string handling, and prevents runtime crashes from server-only imports.
Can I use this skill for VTEX IO admin panels or backend services?
No. It strictly excludes admin UI, GraphQL schemas, service runtime routes, and block registration contracts. Those areas rely on separate VTEX IO skills.