Skip to main content
skill CX Codex

sales-app-extensibility — Claude Code skill: setup and use

Guides the creation, styling, and deployment of VTEX Sales App extensions. Works through a seven-stage sequence from project checks to final delivery.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add vtex/skills --skill sales-app-extensibility -a claude-code
Open on GitHub

What sales-app-extensibility does

This skill guides the scaffolding of user interface widgets for VTEX Sales App. It supports insertion points inside shopping carts, product detail views, and navigation drawers. Work proceeds through fixed phases. First comes project validation, followed by scoping, planning, asset generation, documentation, and production builds. Styles must stay in basic .css files rather than CSS modules.

Strict architectural constraints apply throughout the workflow. Registered extension components must always output a JSX.Element rather than null. If data is absent, the code returns an empty fragment <></> to prevent TypeScript compile errors. Handlers for hooks like useCartItem must guard every optional field before reading values.

Without a configured FastStore setup and a Sales App workspace, code generation halts immediately.

What it helps with

  • scaffold UI widgets for VTEX Sales App cart and PDP slots
  • bind React hooks like useCart and usePDP to supported extension points
  • connect external endpoints through the VTEX IO server proxy
  • prevent TypeScript compile crashes caused by null returns in extensions

Example prompts for the agent

  • Create a promotional banner extension for cart.order-summary.after
  • Add a custom warranty block to the product page via pdp.sidebar.before
  • Generate a menu item extension linked to external customer data

How to install sales-app-extensibility

1Skills CLI (Vercel)

npx skills add vtex/skills --skill sales-app-extensibility -a claude-code

2Manually: put the files in place

~/.claude/skills/sales-app-extensibility/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/sales-app-extensibility/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about sales-app-extensibility

How do I install sales-app-extensibility in Claude Code?

Run npx skills add vtex/skills --skill sales-app-extensibility -a claude-code. The file will be placed in ~/.claude/skills/sales-app-extensibility/SKILL.md.

What does sales-app-extensibility do?

It automates extension development for VTEX Sales App. The skill handles TypeScript component generation, validates hook usage, and creates markdown documentation for each module.

What prerequisites are required before generating code?

The repository root needs a FastStore configuration including faststore.json and turbo.json. An active Sales App workspace must be declared in root workspace dependencies.

Similar skills

Everything for Frontend and UI →

From the same set43

marketplace-rate-limiting Teaches your agent to handle VTEX API 429s: exponential backoff with jitter, rate limit headers, circuit breaker and request queuing. CX Codex +1 1,000installs payment-async-flow Rules for VTEX payment connector code: Boleto, Pix, bank redirects, callbackUrl handling and signature validation. CX Codex +1 1,000installs payment-pci-security Enforces PCI DSS requirements and Secure Proxy routing when building payment connectors that handle card authorization, token exchange, and post-auth requests. CX Codex +1 1,000installs payment-provider-framework This skill guides VTEX IO payment connector work, from PPF wiring to Secure Proxy and build checks. Use it when implementing or maintaining a connector app. CX Codex +1 979installs vtex-io-storefront-theme-versioning Guides coding agents through publishing, updating, or rolling back VTEX IO storefront themes without losing merchant Site Editor data across major versions. CX Codex +1 777installs vtex-io-rootpath A skill for VTEX IO apps in multi-binding stores: shows how to build URLs with the binding's path prefix. Useful when links 404 or point to the wrong locale. CX Codex +1 740installs vtex-io-rbac Walks you through locking down VTEX IO app routes and resources: role policies, resource policies, VRN principals and @auth directives. CX Codex +1 737installs masterdata-storage-strategy Guides data architecture decisions in VTEX, helping configure Master Data JSON schemas with indexing, security, and caching rules before creating entities. CX Codex +1 719installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor