vtexOfficial·43 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 schemas. Prevents costly production mistakes like PCI violations, duplicate payment charges, exposed API keys, and lost Site Editor content during theme upgrades. Ships 40 skills in six export formats so the same rules work in Cursor, Copilot, Claude, and other coding tools.

39|9

↗

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

Available:

The root file tells agents how to author and validate new skills in this repository, while the exported AGENTS.md routes incoming development requests to the correct VTEX track (payments, marketplace, FastStore, IO, headless, Master Data) with per-track constraints.

All Skills in This Repository (43)

Pure Emerald Level Indicators

📦 In Repo

vtex

payment-provider-protocol

Implement and validate VTEX Payment Provider Protocol connectors across required PPP endpoints.

payment-pci-security

Route tokenized card data through a Secure Proxy for PCI DSS compliance.

payment-provider-framework

Implement VTEX IO payment connectors with PaymentProvider and PaymentProviderService.

payment-idempotency

Enforce idempotency for payment operations using paymentId and requestId guards.

payment-async-flow

Coordinate async payment flows with undefined status, callback URLs, and idempotent Create Payment handling.

marketplace-fulfillment

Coordinate external seller fulfillment workflows for VTEX marketplaces.

marketplace-catalog-sync

Automate VTEX marketplace catalog sync via Change Notification and SKU suggestion workflows.

marketplace-order-hook

Process VTEX marketplace order webhooks with authentication and deduplication.

marketplace-rate-limiting

Manage VTEX API rate limits with exponential backoff and circuit breaking.

vtex-io-service-apps

Automate VTEX IO backend service setup with typed IOClients and REST routes.

vtex-io-storefront-react

Design and document shopper-facing React components for VTEX IO storefronts.

vtex-io-auth-tokens-and-context

Select and propagate VTEX IO authentication tokens for backend requests.

Official

Advanced

Frequently Asked Questions

FAQPage Schema

How to install VTEX Skills?▼

Run `npx skills add vtex/ai-skills --all -g -y` in your terminal to install all 40 skills globally for your coding agent.

What do VTEX Skills cover?▼

They cover FastStore storefronts, VTEX IO app development, payment connector protocols, marketplace seller integration, headless BFF security, and Master Data schema design, all based on official VTEX documentation.

Which coding tools work with VTEX Skills?▼

The skills export to six formats including AGENTS.md, Cursor rules, Copilot instructions, Claude project knowledge, OpenCode, and Kiro, so they work with most popular coding agents.

How do these skills prevent payment errors?▼

They enforce idempotency keys, correct async payment status handling, and PCI-compliant Secure Proxy usage, stopping duplicate charges and card data leaks before they reach production.

Do I need VTEX experience to use these skills?▼

No. The skills encode VTEX-specific constraints and correct code patterns, so your coding agent applies platform best practices automatically even if you are new to VTEX.