Setting the issue. One moment.
Contents
Issue No. 38Wix.com · Official
wix /skills
Wix Skills
20 chapters · 3 hours 46 minutes · 49,405 words
Wix Skills
20 chapters · 3 hours 46 minutes · 49,405 words
20 chapters · 226 min
npx skills add wix/skills/plugin marketplace add wix/skillsTypeset in this issue’s own colours, resolved from a curated brand profile.
⚠️ 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 (opens in a new tab) to learn more. For an overview of how skills work with AI tools, see About Wix Skills (opens in a new tab).
main, last pushed 10 August 2026.SKILL.md, not by matching a directory convention. 4 distinct layouts observed: .claude/skills/*/SKILL.md, skills/*/SKILL.md, skills/wix-headless/*/skill.md, skills/wix-replatform/resources/*/SKILL.md.h1 and no skipped levels:.claude-plugin/marketplace.json by Wix, declaring 1 plugin. It is read for editorial metadata only — never as the skill index, which is always the repository tree.In Claude Code (opens in a new tab), run:
/plugin marketplace add wix/skills
/plugin install wix@wixCodex App — Install the Wix plugin (opens in a new tab).
Codex CLI — run /plugins, select Wix, and choose Install Plugin.
In VS Code, open the Command Palette (CMD+SHIFT+P), select Chat: Install Plugin From Source, and enter https://github.com/wix/skills.
Go to Settings > Rules > New Rule > Add from Github with https://github.com/wix/skills.git.
Install using Gemini CLI (opens in a new tab):
gemini extensions install https://github.com/wix/skillsInstall using skills CLI (opens in a new tab):
# Install all skills
npx skills add wix/skills
# Install globally
npx skills add wix/skills -g| 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 | Connect Wix business services to a headless frontend (SDK + Wix CLI), and optionally build & host the site | Setting up a Wix Headless backend or adding Wix business features (Stores, Bookings, CMS, Blog, Events, Forms, Members, Restaurants, Portfolio, Pricing Plans) — install apps, seed content, and produce an SDK-integration guide; for managed projects also scaffold a new site (create) or wire an existing design (connect), then build and release. Works across managed, self-managed, and stripe project types |
| 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 (opens in a new tab) | 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 |
These skills work with any agent that supports the Agent Skills specification (opens in a new tab):
@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.
Run the release-bump (opens in a new tab) 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 (opens in a new tab) publishes to npm via Trusted Publishing.
Besides the npm package, skills are served as raw markdown / .tgz at https://www.wix.com/skills/<name> (also dev.wix.com/skills), directly from this repo’s main branch with no build step. Responses are cached, so a merge to main reflects there within a few minutes.
See CONTRIBUTING.md (opens in a new tab) for guidelines on adding new skills.
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.
MIT
/wix/skills.md, and each chapter at its own .md URL.