VTEX Sales App Extensions Skill
Learn about the AI skill that supports you during the development lifecycle of VTEX Sales App extensions.
This feature is in beta, and we're actively working to improve it. If you have any questions, please contact our Support.
VTEX Sales App Extensions Skill is an AI-powered skill with embedded knowledge of Sales App and FastStore monorepo. It supports you throughout the development lifecycle of extensions, known as VTEX Sales App Extensibility.
In the VTEX Skills collection, the VTEX Sales App Extension Skill is identified as sales-app-extensibility.
For business context, extension point locations, and use case examples, see the article VTEX Sales App Extensibility. For technical information, see our developer extensibility documentation.
The VTEX Sales App Extensions Skill is identified as the sales-app-extensibility skill that's part of the VTEX Skills collection.
When Extensions Skill applies
Use this skill when building, customizing, or deploying extensions for Sales App, such as when:
- ✅ Adding features to the cart page (promotions, loyalty, services).
- ✅ Adding features to the Product Detail Pages (badges, recommendations, warranties).
- ✅ Adding features to the menu (user profile, navigation, metrics).
- ✅ Integrating external APIs into Sales App extensions.
- ✅ Generating, scaffolding, or validating extension code for Sales App.
Don't use this skill for:
- ❌ Regular FastStore storefront customization. Use the
faststore-storefrontskill instead. - ❌ Building VTEX IO apps. Use the
vtex-io-*skills instead. - ❌ Sales App core development or framework modifications.
Skill lifecycle coverage
You can install the Extensions Skill before you start an extensibility project so your AI coding assistant can follow Sales App patterns, and established hooks.
The Extensions Skill supports every stage from setup to production, and follows a seven-step workflow:
| Step | What the skill does |
|---|---|
| Check prerequisites | Checks whether the project prerequisites defined in the Extensibility technical documentation are satisfied before proceeding with the workflow. If any prerequisite is missing, the workflow provides the required commands for manual execution and waits for confirmation before moving to the next step. |
| Discovery | Understands what you want to build. |
| Requirements and plan | Maps requirements and generates an implementation plan. Helps delimit project scope—what to build, which extension point to use, and whether the project involves VTEX IO apps, external integrations, or UX changes. |
| Code generation and validation | Generates extension code using Sales App hooks and platform patterns, keeping UX consistent with ecommerce when the feature already exists online. Reviews requirements for gaps or ambiguities in user flows, integrations, or technical details, and prompts for missing information. |
| Documentation | Generates docs/<ExtensionName>.md to document the extension. |
| Local testing | Provides development commands and URLs to test the extension locally. |
| Build and deploy | Guides you through local previews, builds, and deployment to production, including validation before release. |
Extensions Skill installation
Since the sales-app-extensibility skill is part of the VTEX Skills collection, see the VTEX Skills source code for installation instructions.
For technical information about VTEX Sales App Extensibility, see our developer documentation.