wix-headless-replatform
Role
Drive a close-enough, visually polished Wix Headless frontend from a source website.
The implemented scope is one resolved home page and the default output is
projects/<project-name>, derived from the hostname. Use Wix CLI Headless, Astro,
TypeScript, and Tailwind; use React only for complex interactive islands.
Reject additional-page and explicit-URL scope with an actionable explanation until a later
approved workflow defines page resolution and shared evidence across routes.
This entry skill is the supervisor. It decides the next workflow stage and loads only the
resource for that stage. Do not preload every resource or reference: stage-specific rules
are deliberately demand-loaded.
Two modes exist:
- Standalone clone: source URL to a new, real Wix CLI Headless project.
- Migration phase:
--handoff <migration-project>/website/handoff.json continues on
the migration-owned destination. Never omit --handoff for an integrated migration:
the standalone command creates a second site.
Non-negotiable invariants
- Treat the requested public branded homepage as authorized; apply the boundaries in
references/safety.md without asking a separate routine authorization question.
- Browser-backed extraction is mandatory. Do not substitute HTML-only extraction.
- Resolve the home page before capture. Build only from a validated frozen extraction
manifest; raw observations are never builder inputs.
- A standalone output must be a successful Wix CLI scaffold with valid Wix identity and
runnable
dev and build scripts. Never hand-create a Wix-shaped substitute.
- In migration mode, reuse the handoff's site/project and route/data-binding intent; do
not create or retarget a second destination.
- Preserve source structure, first-viewport evidence, chrome hierarchy, source assets,
fonts, core interactions, SEO, internal URL behavior, and branded fallback behavior.
- A build is not completion. Completion requires the accepted post-build visual-review and
gap-loop evidence described by
rp-qa-gap-loop, plus optional facelift acceptance only
when the user explicitly selected facelift mode.
Supervisor protocol
On every new or resumed run:
- Resolve the source URL, output directory, and mode. In migration mode read
website/handoff.json and docs/site-clone/frontend-automation-state.json first.
- Select the first incomplete stage from the table below and read only that resource's
SKILL.md plus the references it explicitly needs.
- Execute that stage until it writes its required durable artifact, or records a specific
genuine blocker with evidence and an exact unblock action.
- Re-select the stage after every boundary. Do not say that a required next step “needs to
happen” and end the run; load its resource and perform it.
| Stage |
Load only when |
Resource |
Durable outcome |
| Context |
mode, scope, project, or browser environment is unresolved |
resources/rp-project-context/SKILL.md |
valid context, approval record, runnable project/plan state, or blocker |
| Evidence |
frozen home-page extraction is absent or stale |
resources/rp-source-evidence/SKILL.md |
validated extraction/latest.json and frozen manifest, or global blocker |
| Implementation |
frozen build plan exists and home UI is incomplete |
resources/rp-ui-implementation/SKILL.md |
manifest-hash-aware runnable home implementation |
| Verify and improve |
build, QA, comparison, review, fix, report, release, or receipt is incomplete |
resources/rp-qa-gap-loop/SKILL.md |
accepted result, done_with_gaps, or global blocker |
| Optional facelift |
normal clone accepted and automation state says facelift is requested |
resources/rp-facelift/SKILL.md |
accepted facelift review, or blocker |
When frontendPhase.allowedNow is plan, complete only the plan-eligible context and
evidence work and leave a resumable plan-state record. When it is build, continue through
implementation and verification against the migration-owned project.
One-click continuation
A migration handoff declaring automationMode: "one_click" authorizes routine scope and
frontend checkpoints. Record those approvals in
docs/site-clone/frontend-automation-state.json; do not pause to ask whether to proceed
with a required stage, screenshot review, or authorized gap-fix pass.
An explicit facelift request may be carried from 1-click intake, but it remains gated until
normal clone acceptance; 1-click never implies facelift by itself.
In a one-click build run, keep selecting and executing stages until one of these durable
outcomes exists:
website/completion.json is valid and the latest visual review is complete with no open
critical/high identity finding; or
- five visual gap cycles have been completed and
website/completion.json records the
truthful terminal status done_with_gaps with the final reviewed evidence; or
- a genuine blocker is recorded with owner, evidence, attempted recovery, and exact next
authority/action needed.
An owned local extraction gap is not a genuine blocker. Continue unrelated work, use no more
than two distinct targeted recovery attempts, then build the affected dependency closure
provisionally and surface post-assembly choices in final-report.json and .md.
Before classifying a shell, browser, or network failure as a blocker, use the
repo-local Wix/Yarn toolchain PATH ordering and follow the recovery order in
resources/rp-project-context/SKILL.md: aligned-shell retry, then the
required browser/network escalation and retry, then blocker only if it still
fails or approval is pending. After every gap iteration, immediately return to
the stage table; never treat a first build, a reported plan, or backend import
as frontend completion.
Commands
Run node scripts/site-clone.mjs <source-url> for standalone mode, or
node scripts/site-clone.mjs <source-url> --handoff <path> for migration mode. The active
resource gives the exact commands and inputs for its stage.
References
Resources load their own references. The shared contracts are kept under references/:
safety.md, workflow.md, extraction-schema.md, output-contract.md,
qa-checklist.md, and the interaction/layout/control/normalization/gap contracts.
1---2name: wix-headless-replatform3description: Clone, rebuild, migrate, or reverse-engineer a public website home page into a Wix Headless frontend while preserving source identity, SEO, interactions, and visual fidelity.4metadata:5 source: https://skillmd.com/skills/wix/wix-headless-replatform6---78# wix-headless-replatform910## Role1112Drive a close-enough, visually polished Wix Headless frontend from a source website.13The implemented scope is one resolved home page and the default output is14`projects/<project-name>`, derived from the hostname. Use Wix CLI Headless, Astro,15TypeScript, and Tailwind; use React only for complex interactive islands.16Reject additional-page and explicit-URL scope with an actionable explanation until a later17approved workflow defines page resolution and shared evidence across routes.1819This entry skill is the supervisor. It decides the next workflow stage and loads only the20resource for that stage. Do not preload every resource or reference: stage-specific rules21are deliberately demand-loaded.2223Two modes exist:2425- **Standalone clone:** source URL to a new, real Wix CLI Headless project.26- **Migration phase:** `--handoff <migration-project>/website/handoff.json` continues on27 the migration-owned destination. Never omit `--handoff` for an integrated migration:28 the standalone command creates a second site.2930## Non-negotiable invariants3132- Treat the requested public branded homepage as authorized; apply the boundaries in33 `references/safety.md` without asking a separate routine authorization question.34- Browser-backed extraction is mandatory. Do not substitute HTML-only extraction.35- Resolve the home page before capture. Build only from a validated frozen extraction36 manifest; raw observations are never builder inputs.37- A standalone output must be a successful Wix CLI scaffold with valid Wix identity and38 runnable `dev` and `build` scripts. Never hand-create a Wix-shaped substitute.39- In migration mode, reuse the handoff's site/project and route/data-binding intent; do40 not create or retarget a second destination.41- Preserve source structure, first-viewport evidence, chrome hierarchy, source assets,42 fonts, core interactions, SEO, internal URL behavior, and branded fallback behavior.43- A build is not completion. Completion requires the accepted post-build visual-review and44 gap-loop evidence described by `rp-qa-gap-loop`, plus optional facelift acceptance only45 when the user explicitly selected facelift mode.4647## Supervisor protocol4849On every new or resumed run:50511. Resolve the source URL, output directory, and mode. In migration mode read52 `website/handoff.json` and `docs/site-clone/frontend-automation-state.json` first.532. Select the first incomplete stage from the table below and read only that resource's54 `SKILL.md` plus the references it explicitly needs.553. Execute that stage until it writes its required durable artifact, or records a specific56 genuine blocker with evidence and an exact unblock action.574. Re-select the stage after every boundary. Do not say that a required next step “needs to58 happen” and end the run; load its resource and perform it.5960| Stage | Load only when | Resource | Durable outcome |61| --- | --- | --- | --- |62| Context | mode, scope, project, or browser environment is unresolved | `resources/rp-project-context/SKILL.md` | valid context, approval record, runnable project/plan state, or blocker |63| Evidence | frozen home-page extraction is absent or stale | `resources/rp-source-evidence/SKILL.md` | validated `extraction/latest.json` and frozen manifest, or global blocker |64| Implementation | frozen build plan exists and home UI is incomplete | `resources/rp-ui-implementation/SKILL.md` | manifest-hash-aware runnable home implementation |65| Verify and improve | build, QA, comparison, review, fix, report, release, or receipt is incomplete | `resources/rp-qa-gap-loop/SKILL.md` | accepted result, `done_with_gaps`, or global blocker |66| Optional facelift | normal clone accepted and automation state says facelift is requested | `resources/rp-facelift/SKILL.md` | accepted facelift review, or blocker |6768When `frontendPhase.allowedNow` is `plan`, complete only the plan-eligible context and69evidence work and leave a resumable plan-state record. When it is `build`, continue through70implementation and verification against the migration-owned project.7172## One-click continuation7374A migration handoff declaring `automationMode: "one_click"` authorizes routine scope and75frontend checkpoints. Record those approvals in76`docs/site-clone/frontend-automation-state.json`; do not pause to ask whether to proceed77with a required stage, screenshot review, or authorized gap-fix pass.78An explicit facelift request may be carried from 1-click intake, but it remains gated until79normal clone acceptance; 1-click never implies facelift by itself.8081In a one-click build run, keep selecting and executing stages until one of these durable82outcomes exists:8384- `website/completion.json` is valid and the latest visual review is complete with no open85 critical/high identity finding; or86- five visual gap cycles have been completed and `website/completion.json` records the87 truthful terminal status `done_with_gaps` with the final reviewed evidence; or88- a genuine blocker is recorded with owner, evidence, attempted recovery, and exact next89 authority/action needed.9091An owned local extraction gap is not a genuine blocker. Continue unrelated work, use no more92than two distinct targeted recovery attempts, then build the affected dependency closure93provisionally and surface post-assembly choices in `final-report.json` and `.md`.9495Before classifying a shell, browser, or network failure as a blocker, use the96repo-local Wix/Yarn toolchain PATH ordering and follow the recovery order in97`resources/rp-project-context/SKILL.md`: aligned-shell retry, then the98required browser/network escalation and retry, then blocker only if it still99fails or approval is pending. After every gap iteration, immediately return to100the stage table; never treat a first build, a reported plan, or backend import101as frontend completion.102103## Commands104105Run `node scripts/site-clone.mjs <source-url>` for standalone mode, or106`node scripts/site-clone.mjs <source-url> --handoff <path>` for migration mode. The active107resource gives the exact commands and inputs for its stage.108109## References110111Resources load their own references. The shared contracts are kept under `references/`:112`safety.md`, `workflow.md`, `extraction-schema.md`, `output-contract.md`,113`qa-checklist.md`, and the interaction/layout/control/normalization/gap contracts.