wix-headless — Orchestrateur de génération de site Wix Headless
Ce skill fait partie du repo officiel wix/skills, une collection de skills expérimentaux pour construire des applications Wix avec des assistants IA. Il s'agit du skill le plus complet du repo : son rôle est d'agir comme orchestrateur principal pour la création d'un site Wix Managed Headless complet à partir d'une seule requête utilisateur (« build me a site », « I want to sell online », etc.).
Ce que fait ce skill
Le SKILL.md définit un pipeline linéaire en six vagues (waves) qui se déroule de la découverte jusqu'au déploiement. L'orchestrateur coordonne des sous-agents workers généralistes, chacun chargé d'un périmètre précis via un fichier INSTRUCTIONS.md dédié. Les phases couvrent : la discovery (brand, vibe, verticals), le setup (installation d'apps Wix, env pull, npm install), le seeding de données CMS/stores/blog, la génération du design system (tokens, Layout, Navigation), la création des composants React et des pages Astro, la génération d'images décoratives et d'entités, puis le build et le release via le Wix CLI.
Architecture interne
Le skill s'appuie sur un ensemble de fichiers de référence situés dans references/ (contrats de retour des sous-agents, guides MCP, instructions par vertical, schémas), des scripts Node.js dans scripts/ (scaffold, seed-utilities, emit-design-tokens, check-manifest, release, etc.), des templates dans templates/, et des utilitaires partagés dans shared-utilities/. Les verticals supportés sont stores, ecom, cms, blog, forms, gift-cards et images/designer. L'orchestrateur est le seul responsable de l'écriture de .wix/site.json, source de vérité centrale pour toute la session.
Comment l'utiliser
Ce skill se déclenche automatiquement lorsqu'un assistant IA compatible (Claude Code, Cursor, Codex, Gemini CLI, etc.) détecte une intention de créer un nouveau site. Il suffit d'installer le plugin wix/skills dans l'assistant de son choix (voir le README du repo), puis de formuler une demande de création de site. Le skill guide ensuite l'utilisateur avec deux questions (nom de la marque, ambiance visuelle), présente un plan pour validation, puis exécute l'intégralité du pipeline de manière autonome jusqu'à fournir l'URL de déploiement.
⚠️ Ce repo est en développement expérimental. Les APIs, définitions de skills et comportements peuvent changer sans préavis.