vtexdocsOfficial·21 Agent Skills Included

ai-skills

VTEX commerce development rules for storefronts, payments, and integrations

Guides coding agents through VTEX platform development across FastStore storefronts, VTEX IO apps, payment connectors, marketplace integrations, headless BFF layers, and Master Data. Encodes hard constraints like PCI Secure Proxy scope, payment idempotency, BFF credential isolation, and the 2.5-second fulfillment simulation SLA. Prevents costly production mistakes that generic coding assistants miss, with paired correct and wrong code examples.

39|9

↗

npx skills add vtexdocs/ai-skills --all -g -y

Available:

Routes the agent to the correct VTEX track (payments, marketplace, IO apps, headless, FastStore, Master Data, architecture) based on the developer's task, with per-track behavioral rules and constraints.

All Skills in This Repository (21)

Pure Emerald Level Indicators

📦 In Repo

vtexdocs

payment-provider-protocol

Implement VTEX Payment Provider Protocol PPP connectors with endpoint contracts and manifest requirements.

payment-pci-security

Enforces PCI-compliant card data handling and Secure Proxy routing for VTEX payment connectors.

payment-idempotency

Enforce idempotency in payment flows using paymentId and requestId keys.

payment-async-flow

Implement asynchronous payment flows with callback-based settling for Boleto and Pix.

marketplace-fulfillment

Automate VTEX marketplace fulfillment authorization, invoicing, and tracking updates.

marketplace-catalog-sync

Coordinate VTEX marketplace change notifications and SKU suggestions for seller catalogs.

marketplace-order-hook

Configure VTEX order webhooks with Feed v3 and Hook filters.

marketplace-rate-limiting

Configure retry logic with exponential backoff for VTEX marketplace API calls.

vtex-io-app-structure

Align VTEX IO app scaffolding with manifest, builders, and policy best practices.

vtex-io-service-apps

Standardize VTEX IO backend services with IOClients and service wiring.

vtex-io-react-apps

Builds VTEX IO React components for storefront blocks and admin panels using interfaces.json and GraphQL data fetching via useQuery.

vtex-io-masterdata

Manage Master Data v2 entities and schemas with MasterDataClient in VTEX IO apps.

Official

Advanced

Frequently Asked Questions

FAQPage Schema

How to install VTEX Skills?▼

Run `npx skills add vtexdocs/ai-skills --all -g -y` in your terminal to install all VTEX development skills globally.

What VTEX development tasks do these skills cover?▼

They cover FastStore storefronts, VTEX IO app development, payment connector protocols, marketplace seller integrations, headless BFF architecture, and Master Data schema design.

Why use VTEX-specific skills instead of a general coding assistant?▼

Generic models miss VTEX-specific constraints like PCI Secure Proxy scope, payment idempotency keys, and the 60-schema Master Data limit, which cause production failures. These skills encode those rules with correct and wrong code examples.

Which coding tools support these VTEX skills?▼

They work with Claude Code, Cursor, GitHub Copilot, OpenCode, Windsurf, and any tool that reads AGENTS.md or SKILL.md files.

Do I need VTEX experience to use these skills?▼

No. The skills guide the agent through VTEX conventions automatically, so developers new to the platform get correct patterns without reading the full documentation first.