wix / skills
★ 21A skill package that teaches your agent 4 capabilities — every one documented and browsable below, no GitHub required · by wix.
Each skill below is one capability this package teaches your agent. Install the whole package, or open a skill to install just that one.
Build and review Wix CLI app extensions — dashboard pages, modals, plugins, menu plugins, custom element widgets, Editor React components, site plugins,…
50 files — installable on its own
Wix Design System component reference. Use when building UI with @wix/design-system, choosing components, checking props and examples, or writing tests with…
5 files — installable on its own
Build a complete Wix Managed Headless site from a single prompt. Entry point for ANY new-site request — runs discovery, design, feature wiring, and preview in…
50 files — installable on its own
Wix business solution management recipes — REST API operations for configuring and managing Wix business solutions. Routes to: stores, bookings, get-paid, CMS,…
50 files — installable on its own
Wix Skills
⚠️ EXPERIMENTAL: This project is in early development. APIs, skill definitions, and behavior may change without notice. Use at your own risk.
Agent skills for building Wix app extensions, managing Wix business solutions, developing headless sites, and using the Wix Design System with AI agents.
Note: These skills are designed for the new Wix CLI. See About the Wix CLI to learn more. For an overview of how skills work with AI tools, see About Wix Skills.
Installation
Claude Code Plugin
In Claude Code, run:
/plugin marketplace add wix/skills
/plugin install wix@wixCodex
Codex App — Install the Wix plugin.
Codex CLI — run /plugins, select Wix, and choose Install Plugin.
VS Code Plugin
In VS Code, open the Command Palette (CMD+SHIFT+P), select Chat: Install Plugin From Source, and enter https://github.com/wix/skills.
Cursor Plugin
Go to Settings > Rules > New Rule > Add from Github with https://github.com/wix/skills.git.
Gemini CLI
Install using Gemini CLI:
gemini extensions install https://github.com/wix/skillsSkills CLI
Install using skills CLI:
# Install all skills
npx skills add wix/skills
# Install globally
npx skills add wix/skills -gAvailable Skills
| Skill | Purpose | When to Use |
|---|---|---|
| wix-app | Build Wix app extensions | Adding any extension — dashboard pages, site widgets, backend events, service plugins, embedded scripts, data collections, and more |
| wix-design-system | Wix Design System reference | Looking up WDS component props, examples, icons |
| wix-manage | Wix business solution management | REST API operations for configuring and managing Wix business solutions |
| wix-headless | Build a complete Wix Managed Headless site | Building a new site end-to-end from a single prompt — discovery, design, feature wiring, and preview |
| wix-vibe-headless | Connect an existing front end to Wix over client-only REST | Wiring a vibe-coded / HTML / Vite app to a live Wix site (storefront, bookings, blog, events, portfolio, restaurants, CMS, pricing plans) from the browser with a public WIX_CLIENT_ID — no SDK, no backend |
| wix-docs | Look up the Wix API/SDK docs (shared fallback) | Confirming an exact Wix endpoint, method schema, field, or enum before writing code — curl doc-search + the .md-twin trick, or the Wix MCP tools. Referenced by the other skills as their docs-lookup fallback |
| replatform | Migrate sites from WordPress and other platforms into Wix | Migrating an exiting business from another platform into Wix. Both backend data and website. npx skills add wix/skills/replatform |
Supported Agents
These skills work with any agent that supports the Agent Skills specification:
- Cursor
- Claude Code
- Gemini CLI
- Codex CLI
- GitHub Copilot
- Windsurf
- And many more
Versioning
@wix/agent-skills follows semver. Bumps target AI-generated-code stability — i.e., whether a change could cause an agent using these skills to produce broken code on the previous-major wix-cli:
| Bump | Examples |
|---|---|
| patch | Wording fix, typo, link update, clarification of existing guidance |
| minor | New skill added, new section in an existing skill, additive guidance for a non-breaking wix-cli feature |
| major | Skill rename/removal, rewrite of guidance for a deprecated wix-cli API, anything that would cause AI-generated code to fail on the previous-major wix-cli |
When a major bump is required (a breaking change in the underlying wix-cli), the previous major continues on a release/<N>.x maintenance branch and receives backports for genuine bugs only — no new features.
Releasing
Run the release-bump workflow from the Actions tab and pick a version_strategy. The rest is automatic — the bump PR auto-merges once checks pass and release.yml publishes to npm via Trusted Publishing.
Contributing
See CONTRIBUTING.md for guidelines on adding new skills.
Eval Token Budgets
Eval scenarios under yaml/wix-manage-evals/ may define a top-level maxTokens value. The GitHub Actions eval gate compares that budget against the PR run's total tokens for the scenario and fails the PR check when the budget is exceeded. This gate-owned field is separate from llm_judge.maxTokens, which only configures the judge assertion.
License
MIT
Install the whole package (4 skills):
npx skills add https://github.com/wix/skillsOr install a single skill:
npx skills add https://github.com/wix/skills --skill <name>Pick the skill name from the Skills tab — each entry there installs independently.