skilld
All skills
wix avatar

/wix-headless

@8f7fa5d official
by Wix.comwix/skills33 stars
33

Connect Wix business services (Stores, Bookings, CMS, Blog, Events, Forms, and more) to a Wix Headless frontend — infer the needed capabilities, install the apps, seed backend content, and produce an SDK-integration guide. For managed (Wix-hosted) projects it can also build the frontend: scaffold a new site (create) or wire an existing/brought-in design (connect), then build and release. Works across managed, self-managed, and stripe project types. Triggers: set up a Wix Headless backend, add Wix business features to my app, build or host a Wix site, connect/implement this design with Wix.

Ask your Agent

Use this Skill: https://skilld.dev/gh/wix/skills/wix-headless

This session only. Nothing lands on disk.

referencesDOC_DISCOVERY.md

≈652 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Doc discovery — the shared fallback (seeding and code-writing)

You're here because a pinned page or recipe didn't cover what you need — a field, an endpoint, an error, or an unpinned method. Doc discovery is the fallback for both tracks, never the first move:

  • Seeding → read the capability's inline recipe — inline-recipes/setup-*.md, mapped in SEED.md § "What to seed per capability". Each built capability is a self-contained local recipe that inlines the calls and supersedes the REST doc pages — seed from it alone. Only a capability with no inline recipe (e.g. coupons) discovers from the live docs (below).
  • Code-writing → try the pinned pages in astro.md / non-astro.md + inline-recipes/*.
  • Only when those fall short, discover from the live docs (below).

The wix-docs skill is the full playbook (../wix-docs/SKILL.md when co-installed). The short version:

1. Find a page — semantic curl search (no MCP required):

curl -sS -X POST 'https://www.wixapis.com/mcp-docs-search/v1/docs/search/markdown' \
  -H 'Content-Type: application/json' \
  --data-raw '{"search_term":"<what you need, in natural language>","document_type":"WIX_HEADLESS","maximum_results":3}'

document_type: SDK / WIX_HEADLESS for code-writing, REST / BUSINESS_SOLUTIONS for seeding, and SKILLS for a multi-step workflow no pinned recipe covers — it searches the dedicated recipe corpus (step ordering, cross-step gotchas), which a REST search does not return (also VELO · WDS · BUILD_APPS · CLI · OVERVIEW). Drop /markdown for JSON hits. Found a recipe → resolve its individual calls against SDK/REST docs; no recipe → assemble the flow from verified per-method contracts.

2. Read a page — append .md to its docs URL. For an SDK shape, append .md?apiView=SDK — the SDK view shows _id (what the frontend calls), the bare view shows id.

3. Exact structured schema / enums (no MCP) — POST https://mcp.wix.com/api/code-mode/search with getResourceSchemaByUrl(docsUrl) (see wix-docs's API_SPEC_SEARCH.md).

If the host has the Wix MCP, its SearchWix* / SearchWixAPISpec → getResourceSchemaByUrl tools are the same backends without the curl boilerplate — prefer them when present, per wix-docs Lane 2. getResourceSchemaByUrl scopes to the URL: a method URL → that method's contract; a resource URL → the whole resource (fetch that for sibling operations).

A page that IS pinned → read it directly; don't re-search for it.

Source: SKILL.md on GitHub

Third-party checks

1 warning1d3 checks · Risk SAFE
  • Gen Agent Trust Hub1d

    The wix-headless skill is a robust tool for integrating Wix services into headless frontends. It incorporates secure practices for credential management, ensuring tokens remain outside the AI context. While the skill performs remote code execution and has data ingestion surfaces, these actions are carried out through official vendor channels and structured workflows.

  • Socket1d

    1 alert: gptAnomaly

  • Snyk1d

    Risk: LOW · No issues

Provenance

Signed by skilld at 8f7fa5d. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 2 days ago

Capability

What it can do
Runs commands Reads files Edits files
All 16 allowed tools
Bash(curl *)Bash(npx @wix/cli@latest *)Bash(npx @wix/cli *)Bash(npm create @wix/new@latest *)Bash(npm install *)Bash(npm run *)Bash(node *)Bash(cd *)Bash(ls *)Bash(mkdir *)Bash(cp *)Bash(mv *)Bash(uuidgen)ReadWriteEdit

Topics

  • wix
  • headless
  • ecommerce
  • astro
  • vite
  • jsx
  • hosting
  • cms
  • bookings

README badge

README badge for wix/skills/wix-headless

What it does

Scaffolds a new Wix Headless site from scratch or connects an existing HTML/JSX/Vite project to Wix Headless for hosting and business features (ecommerce, bookings, forms, CMS). Handles discovery, design, feature wiring via the Wix SDK, and deployment; routes on operation type (create vs. connect) and frontend framework (Astro by default, or your own build).

Generated from the current SKILL.md.

Frequently asked

Does this skill create a new site or connect an existing one?
Both. Path A creates a new site from scratch based on your description (e.g. 'build me an online store'). Path B connects an existing project (HTML/JSX/Vite app, Claude Design output, etc.) to Wix Headless for hosting and feature wiring.
What happens when I connect an existing project to Wix Headless?
The skill analyzes your project, installs the necessary Wix Business Solutions apps, and wires the Wix SDK directly into your existing source files so each installed app powers its corresponding feature.
What frameworks does this skill support?
For new sites, it defaults to Astro but supports any framework you explicitly name (React, Vue, Svelte, Vite, etc.). For existing projects, it works with HTML, JSX, TSX, Vue, and other web frontends.
Does this skill handle ecommerce, bookings, and content sites?
Yes. It routes to different vertical packs depending on your needs: stores and ecommerce, bookings and appointments, CMS and blogs, forms, and gift cards. All verticals include CMS by default.
How does the skill authenticate with Wix?
It uses the Wix CLI (`npx @wix/cli@latest token`) to generate bearer tokens for API calls. The login flow is safe for non-interactive agents and includes a recovery ladder if needed.

Generated from the current SKILL.md. These answers refresh after source changes.