wix-broker-sync

Validate and synchronize approved broker profiles from canonical Notion records to the Wix CMS collection.

1|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/JFeimster/moonshine-capital-portal --skill wix-broker-sync-jfeimster
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wix-broker-sync
Source: https://github.com/JFeimster/moonshine-capital-portal/tree/main/skills/wix-broker-sync
Command: npx skills add https://github.com/JFeimster/moonshine-capital-portal --skill wix-broker-sync-jfeimster

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Keeping broker profiles consistent between the canonical Notion source of truth and the Wix brokerProfiles CMS collection is error-prone: lifecycle gates can be bypassed, identity fields can drift, and unsafe URLs or unmapped fields can leak into public pages. This Skill enforces a deterministic validation, dry-run, apply, and verification workflow so Wix stays a downstream read replica rather than an accidental source of truth. ## Core Features & Use Cases - Eligibility gating: Blocks synchronization unless approvalStatus is approved and profileStatus is published, and flags missing required fields, slug conflicts, unsafe URLs, and unsupported image schemes. - Three operating modes: Review, dry-run (default, zero writes), and apply, where apply requires explicit authorization and a live re-fetch verification of every changed record. - Canonical-to-Wix field mapping: Maps canonical profile fields to documented Wix field keys, reports unmapped canonical fields, and protects immutable identity and lifecycle values. - Use Case: An operator asks whether partner-110 is ready for Wix publishing. The Skill loads the repository contracts, reads the canonical record, produces a normalized dry-run payload with zero writes, and—only after explicit authorization—applies the sync and verifies it with a live re-fetch. ## Quick Start Ask the assistant to run a dry-run Wix sync review for a specific broker partner ID or slug and show the proposed payload, eligibility decision, and any blocked or unmapped fields.

Frequently Asked Questions about wix-broker-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync approved broker profiles from Notion to Wix?▼

Run a dry run first: the Skill reads the canonical Notion record, checks that approvalStatus is approved and profileStatus is published, and produces the exact normalized Wix payload with zero writes. Apply mode then requires explicit authorization and a live re-fetch verification of each changed record.

What broker profiles are eligible for Wix publishing?▼

A profile is eligible only when approvalStatus equals approved and profileStatus equals published. Records that are draft, hidden, archived, needs_review, suspended, or rejected are blocked, as are records missing required fields like fullName, agencyName, slug, shortBio, city, state, or public contact email.

Can the Skill write directly to the Wix CMS collection?▼

The repository's current lib/wix.ts adapter is read-only, so review and dry-run modes always work but apply mode requires an explicitly authorized Wix write connector or adapter. The Skill never claims a sync succeeded from read-only fetches or fallback mock data.

Why is a broker profile blocked from Wix synchronization?▼

Common blockers include a non-published profileStatus, missing required Wix fields, unsafe or non-HTTPS URLs, unsupported image schemes like wix:image://, slug conflicts with another partner, or canonical data that is stale or sourced only from local fallback. Blocked records are reported, never silently omitted.

What happens to canonical fields that have no Wix field?▼

Fields like partnerId, referralCode, bookingUrl, disclosures, and traceability metadata have no documented Wix collection field. They are reported as unmapped, retained in the canonical source, and never concatenated into unrelated public Wix fields.