wix-headless-templates: скилл Wix Headless
Скилл wix-headless-templates для Claude Code с готовым кодом Wix Headless по бизнес-решениям: слой данных, страницы и сиды.
MIT 301 установок ★ 40 обновлён 2026-10-24
npx skills add wix/skills --skill wix-headless-templates -a claude-codeЧто делает wix-headless-templates
Одна папка на бизнес-решение: storefront, bookings, rentals, blog, cms, forms, members, events, restaurants, donations, pricing-plans, portfolio, faq. Внутри типизированный слой данных и сторы поверх @wix/sdk, React-хуки и эталонные компоненты, страницы Astro с SEO, которое правит владелец сайта, REST-двойник на чистом fetch для сайтов без бандлера, скрипт сида и read-site.mjs, показывающий, что на сайте уже лежит. Контракты хуков и DTO расписаны в INSTRUCTIONS.md.
Общая часть задаёт минимумы дизайна и контента, операции на сервере, которым нужны повышенные права, поиск по сайту и загрузку медиа. blank/ — чистый скаффолд CLI, а compose.mjs пересобирает из него project/ решения вместе с package-lock.json.
Сам скилл сборку не запускает: папку забирает wix-headless-kit через install/templates.mjs и дальше копирует, деплоит и сидит из своей копии. read-site.mjs работает только с залогиненным Wix CLI, поэтому без сессии он ничего не прочитает. Проект после compose.mjs переустанавливает зависимости — перед проверкой типов в нём нужен npm ci.
Какие задачи решает
- Поднять витрину магазина на
@wix/sdkиз готового шаблона - Посмотреть, что уже лежит на сайте, до запуска сида
- Отдать тот же слой данных сайту без сборщика через REST-двойник
- Заполнить сайт контентом из плана идемпотентным скриптом
- Разобрать контракты хуков и DTO по
INSTRUCTIONS.md
Примеры запросов агенту
- Открой шаблон
bookingsи разбери поINSTRUCTIONS.md, какие там контракты хуков и сторов - Запусти
node bookings/seed/read-site.mjs --site <siteId>и скажи, что уже есть на сайте - Пересобери
project/дляstorefrontчерезnode compose.mjs storefrontи объясни, что изменилось
Как установить wix-headless-templates
1Через Skills CLI (Vercel)
npx skills add wix/skills --skill wix-headless-templates -a claude-code2Вручную: положить файлы
~/.claude/skills/wix-headless-templates/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/wix-headless-templates/
1Через Skills CLI (Vercel)
npx skills add wix/skills --skill wix-headless-templates -a codex2Вручную: положить файлы
.agents/skills/wix-headless-templates/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add wix/skills --skill wix-headless-templates -a cursor2Вручную: положить файлы
.cursor/skills/wix-headless-templates/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install wix/skills skills/wix-headless-templates2Вручную: положить файлы
.github/skills/wix-headless-templates/SKILL.md1Через Skills CLI (Vercel)
npx skills add wix/skills --skill wix-headless-templates -a gemini-cli2Командой платформы
gemini skills install https://github.com/wix/skills --path skills/wix-headless-templatesВручную: положить файлы
.devin/skills/wix-headless-templates/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add wix/skills --skill wix-headless-templates -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о wix-headless-templates
Как установить wix-headless-templates в Claude Code?
Выполни npx skills add wix/skills --skill wix-headless-templates -a claude-code, после этого файл скилла лежит в ~/.claude/skills/wix-headless-templates/SKILL.md.
Что делает wix-headless-templates?
Хранит проверенный код сайтов Wix Headless: по папке на бизнес-решение со слоем данных, страницами Astro, сидами и плейбуком контрактов.
Чем он отличается от wix-headless-kit?
Здесь только материал, своего потока у скилла нет. wix-headless-kit забирает папку и уже из своей копии копирует, деплоит и заполняет сайт.
Исходный текст
SKILL.md · MIT
--- name: wix-headless-templates description: "The shipped, verified code behind Wix Headless sites, one folder per Wix Business Solution: an online store, bookings, rentals, a blog, CMS collections, forms, members, events, restaurants, donations, pricing plans, a portfolio, an FAQ. Each ships a typed framework-agnostic data layer and stores over @wix/sdk, React hooks and reference components, Astro pages with owner-editable SEO, a REST twin for sites without a bundler, a seed script that fills the site from a plan, a reader that reports what a site already holds, and a playbook (INSTRUCTIONS.md) with the contracts. Shared across them: design and content floors, the capabilities (site search, media upload), the seed helpers, and a composed, lock-pinned project per solution that a create copies whole. Used by wix-headless-kit, which fetches, deploys and seeds from this folder; readable on its own to see what a solution's code does and how it is seeded." --- # Wix Headless Templates The code a Wix Headless site is built from, one folder per Wix Business Solution. `wix-headless-kit` is the skill that runs a build: its `install/templates.mjs` fetches this folder once into the kit's own `templates/` (a sparse clone of `skills/wix-headless-templates/`, or the checkout when the kit runs from one) and the kit copies, deploys and seeds from there. This skill holds no flow of its own; it is the material, kept as a skill so it is published, mirrored and readable like one. ## Layout | path | what it is | |---|---| | `<solution>/INSTRUCTIONS.md` | the solution's playbook: what ships, the contracts of every hook, store and DTO, the pages, the dashboard links | | `<solution>/app/` | the framework-agnostic core: `wix/<solution>/*-core.ts` (pure logic), the SDK transport, `*-store.ts` state machines, `types.ts`; `hooks/` (React bindings) and `components/` (reference implementations, correct and plain) | | `<solution>/app-astro/` | Astro pages and layouts with owner-editable SEO pre-wired | | `<solution>/rest/` | the data layer a second time over plain `fetch`, same exports, for a site with no bundler | | `<solution>/seed/` | `SEED.md` (the plan shape and the traps), `seed-<solution>.mjs` (fills the site from a plan, idempotent), `read-site.mjs` (reports what the site already holds) | | `<solution>/project/` | the composed project: the CLI's blank scaffold with the solution deployed and a `package-lock.json`, copied whole at create or attach so `npm ci` installs without resolving | | `shared/` | `DESIGN.md` and `CONTENT.md` (the floors every site meets), `CUSTOM_OPERATIONS.md` (server-side work that needs elevated calls), `app/` and `rest/` (the client, media and config seams), `capabilities/` (site search, media upload), `seed/` (the CLI resolver, token, image resolver and site context every seed uses) | | `blank/` | the pristine CLI scaffold the composed projects start from | | `compose.mjs` | repository tooling: rebuilds a solution's `project/` from `blank/` plus a deploy, and its lock | The solutions: `storefront`, `bookings`, `rentals`, `blog`, `cms`, `forms`, `members`, `events`, `restaurants`, `donations`, `pricing-plans`, `portfolio`, `faq`. ## Reading it on its own - What a solution does and how its pieces fit: `<solution>/INSTRUCTIONS.md`, then `app/wix/<solution>/types.ts`. - How a site is filled and what the seed refuses: `<solution>/seed/SEED.md`. - What an existing site holds before anything is written: `node <solution>/seed/read-site.mjs --site <siteId>` (a logged-in Wix CLI). - A seed by hand, from a project folder with a `wix.config.json`: `node <solution>/seed/seed-<solution>.mjs plan.json`. ## Changing it Code under `app/`, `app-astro/`, `rest/` and `seed/` is the source; `project/` is generated from it with `node compose.mjs <solution>` from a checkout of the repository (it reinstalls the project's dependencies, so run `npm ci` in the project before a typecheck). A composed project is checked with `tsc` on its own `tsconfig.json`. Locks are resolved locally, never on a sandbox mirror.
© wix · MIT · wix/skills