vtex/skills

VTEX Skills

41 AI agent skills for VTEX platform development — one source, six export formats.

Quick Start • Tracks • Platforms • Contributing

---

Quick Start

GitHub CLI (Recommended — requires gh v2.90.0+)

If you have the GitHub CLI installed, this is the fastest path. It auto-detects which agents you have configured, supports version pinning, and provides gh skill update to stay current.

# Browse and install skills interactively
gh skill install vtex/skills

# Install a specific skill
gh skill install vtex/skills payment-provider-protocol

# Target a specific agent explicitly
gh skill install vtex/skills payment-provider-protocol --agent claude-code

# Pin to a release for reproducibility
gh skill install vtex/skills payment-provider-protocol --pin v1.9.0

# Keep all installed skills up to date
gh skill update --all

Skills are installed to .agents/skills/ at project scope by default — shared automatically across GitHub Copilot, Cursor, Claude Code, Codex, OpenCode, Windsurf, and 40+ other agents. Use --scope user to install globally instead.

npx (No GitHub CLI required)

Works on any machine with Node.js. Handles bulk installs and is CI-friendly:

npx skills add vtex/skills

Use --list to preview available skills before installing, --all --yes to install everything non-interactively, or --agent to target a specific tool.

Platform-specific installs (fallback)

---

Why Use This?

• AI assistants don’t know VTEX-specific patterns. The Overrides API, PPP endpoints, BFF requirements, and MasterData schema limits aren’t in any LLM’s training data at the depth you need. These skills fill that gap.
• Real constraints, not generic advice. PCI compliance via the Secure Proxy, idempotency requirements on payment endpoints, the 2.5s fulfillment simulation timeout, the 60-schema MasterData limit — these are the details that prevent costly mistakes in production.
• One source, six platforms. Skills are authored once in a canonical Markdown format and exported automatically. No manual sync, no drift between tools.
• Built from official VTEX documentation. Not generic LLM knowledge. Every constraint has a source, a detection pattern, and paired correct/wrong code examples.

---

Supported Platforms

---

Tracks & Skills

---

Open Plugins / Cursor Directory

This repository is an Open Plugin — a portable, platform-agnostic skill pack that any AI coding tool can discover and install.

rules/*.mdc              # Cursor rules (auto-discovered)
skills/*/SKILL.md        # Agent skills (auto-discovered)
.cursor-plugin/plugin.json   # Cursor plugin manifest
.plugin/plugin.json          # Vendor-neutral plugin manifest

Compatible tools (Cursor, Claude Code, and others implementing the Open Plugins spec) can install this repo directly as a plugin. The rules/ and skills/ directories at the repo root follow the standard layout, and the manifests provide metadata for discovery.

---

For Contributors

---

Contributing

See CONTRIBUTING.md for a complete guide on adding skills, tracks, and export platforms.

---

License

See LICENSE for details.