vtex-io-admin-react — Claude Code skill: what it does, how to install
Guides coding agents in building VTEX IO admin pages with React, enforcing official design systems, bounded tables, and predictable feedback states.
npx skills add vtex/skills --skill vtex-io-admin-react -a claude-codeWhat vtex-io-admin-react does
This skill instructs AI assistants on creating operational interfaces under the VTEX IO admin builder. It enforces official design packages—specifically vtex.styleguide for customer-facing store apps and @vtex/shoreline for internal tools. Generic suites like Chakra or Material UI get replaced immediately.
Project structure follows standard VTEX conventions. Navigation entries declared in admin/navigation.json map directly to admin/routes.json and components inside the react/ directory. For heavy tables, the guidelines mandate pagination alongside server-side queries. Loading full datasets into browser memory is prohibited to prevent interface freezes.
Operational actions require clear UI feedback: buttons must display loading spinners, followed by toast alerts upon completion. Without semantic controls from official design systems, clickable div elements break accessibility audits.
What it helps with
- map admin paths between navigation.json, routes.json, and React views
- swap generic UI libraries for vtex.styleguide or Shoreline
- implement loading spinners, empty layouts, and error alerts
- apply pagination and server-side filtering on operational tables
Example prompts for the agent
- Build an admin settings view using PageHeader and PageBlock from vtex.styleguide.
- Add server-side pagination and alert banners to this operational table.
- Refactor form buttons to show pending spinners and trigger toast feedback.
How to install vtex-io-admin-react
1Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-admin-react -a claude-code2Manually: put the files in place
~/.claude/skills/vtex-io-admin-react/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/vtex-io-admin-react/
1Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-admin-react -a codex2Manually: put the files in place
.agents/skills/vtex-io-admin-react/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-admin-react -a cursor2Manually: put the files in place
.cursor/skills/vtex-io-admin-react/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install vtex/skills vtex-io-admin-react2Manually: put the files in place
.github/skills/vtex-io-admin-react/SKILL.md1Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-admin-react -a gemini-cli2Platform CLI
gemini skills install https://github.com/vtex/skills --path skills/vtex-io-admin-reactManually: put the files in place
.devin/skills/vtex-io-admin-react/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-admin-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-admin-react
How to install vtex-io-admin-react in Claude Code?
Run npx skills add vtex/skills --skill vtex-io-admin-react -a claude-code. The rule file will be placed at ~/.claude/skills/vtex-io-admin-react/SKILL.md.
What does the vtex-io-admin-react skill do?
It guides coding models through developing administrative React views in VTEX IO. It enforces official design systems, clean route setups, and visible mutation states.
Which design systems are supported?
The default choice is vtex.styleguide, with @vtex/shoreline accepted for internal back-office tools. Generic options like Ant Design or Material UI are rejected.