@wix/agent-skills 1.8.0 → 1.9.0

package/skills/wix-headless/references/custom/bookings/WIRING.md

@@ -1,88 +1,146 @@
 ---
 name: custom-bookings-wiring
-description: "Integration-mode wiring subagent for the bookings capability. Wires a services list + availability + a book action into a brought-in site — @wix/bookings reads client-side via @wix/sdk, and a redirect to Wix-hosted bookings checkout for the booking itself (mirrors the ecom checkout-redirect pattern). No server runtime required."
+description: "Integration-mode wiring subagent for the bookings capability. Wires a services list + availability + a schema-driven booking form into a brought-in site, then books via the ecom Cart V2 sequence (createBooking → cart → placeOrder / hosted-checkout redirect). Client-side @wix/sdk; no server runtime, no confirmBooking."
 ---
 
-# Bookings — integration wiring
+# Bookings — integration wiring (own / static)
 
-You wire the **bookings capability** (services list + availability + book) into a brought-in site (`frontend = "custom"`). Client-side `@wix/sdk` — CDN imports for `none`-build, bundled imports for `own`-build (same calls). Read `INSTRUCTIONS.md` § "The technical spine" + § "Wiring discipline" first.
+You wire the **bookings capability** into a brought-in site (`frontend = "custom"`).
+Client-side `@wix/sdk` — CDN imports for `none`-build, bundled for `own`-build
+(same calls). Read `INSTRUCTIONS.md` § "The technical spine" + § "Wiring discipline".
 
-> **Scope.** Beta does **services display + availability + redirect-to-Wix-hosted bookings checkout**. The hosted checkout owns payment, the seat-holding confirm, and the customer email — exactly the pieces a client-only site cannot do itself: `confirmBooking` requires the Manage Bookings scope (server-side elevation), and a bare client `createBooking` leaves the booking **`CREATED`, which holds no seat** (the class/slot stays bookable → overbooking). Do NOT ship a client-side `createBooking` as a complete flow. An on-site booking flow (calendar + form + elevated confirm, as in the astro vertical) needs the server runtime — **deferred**.
+> **The logic is shared.** The step model, the booking SDK sequence, the
+> schema-driven form, and the gotchas are in `../../bookings/FLOW.md` — read it
+> first. The astro vertical's React examples
+> (`../../astro/templates/bookings/*` incl. `bookingDriver.ts`) are the reference
+> implementation; here you run the **same SDK calls** through an `OAuthStrategy`
+> visitor client (adapt the React idiom to whatever framework the site uses).
 
-## Inputs (inlined in your prompt)
+> **Scope (same as the astro vertical — the astro/own distinction collapses).**
+> Services display + a week-calendar availability picker + a schema-driven booking
+> form + the **ecom Cart V2 booking sequence**, all client-side under the visitor
+> identity (no server elevation): `createBooking` (→ `CREATED`) → `createCart` →
+> `calculateCart` → `isCheckoutRequired ? ecomCheckout redirect : placeOrder`.
+> **No `confirmBooking`** — the cart holds the seat, so a client-only site
+> completes the whole flow.
 
+## Inputs (inlined in your prompt)
 - **`appId`** — `OAuthStrategy` `clientId`.
-- **Seeded services** — read your `bookings` slice from `.wix/seeded.json` (`services[{id, slug, name, type, durationMinutes, price, currency}]`).
+- **Seeded services** — read your `bookings` slice from `.wix/seeded.json`.
 - The site's CSS token names (style additively from them).
 
-## Render services (wire an existing region, or inject a section)
-
-```html
-<script type="module">
-  import { createClient, OAuthStrategy } from "https://esm.sh/@wix/sdk@1";
-  import { services } from "https://esm.sh/@wix/bookings@1";
-
-  const wix = createClient({ modules: { services }, auth: OAuthStrategy({ clientId: "REPLACE_WITH_APP_ID" }) });
-
-  // Query BUILDER + .find() — the { query: {...} } object form returns 0 items silently.
-  const { items } = await wix.services.queryServices().limit(100).find();
-  const visible = items.filter((s) => !s.hidden);
-  // Bind into the existing markup: name s.name, tagline s.tagLine, slug s.mainSlug?.name,
-  // duration s.schedule?.availabilityConstraints?.sessionDurations?.[0] (APPOINTMENT),
-  // price s.payment?.fixed?.price ({ value, currency } — value is a string; format from
-  // the returned currency, the site business locale wins over what was seeded).
-</script>
+## The client (acquire once)
+```js
+import { createClient, OAuthStrategy } from "https://esm.sh/@wix/sdk@1"; // bundled for own-build
+import { services, availabilityTimeSlots, eventTimeSlots, bookings } from "https://esm.sh/@wix/bookings@1";
+import { forms } from "https://esm.sh/@wix/forms@1";
+import * as cartV2 from "https://esm.sh/@wix/auto_sdk_ecom_cart-v-2@1";
+import { redirects } from "https://esm.sh/@wix/redirects@1";
+
+const wix = createClient({
+  modules: { services, availabilityTimeSlots, eventTimeSlots, bookings, forms, redirects, ...cartV2 },
+  auth: OAuthStrategy({ clientId: "REPLACE_WITH_APP_ID" }),
+});
 ```
 
-## Availability (per selected service)
-
+## Render services
 ```js
-import { availabilityTimeSlots, eventTimeSlots } from "https://esm.sh/@wix/bookings@1";
-// register the module(s) in createClient({ modules: { ... } })
-
-// APPOINTMENT — serviceId is a single GUID STRING (NOT an array):
-const a = await wix.availabilityTimeSlots.listAvailabilityTimeSlots({
-  serviceId, fromLocalDate, toLocalDate, timeZone, bookable: true, cursorPaging: { limit: 50 },
-});
-// slots: a.timeSlots[] — localStartDate/localEndDate/scheduleId at the TOP level.
+// The filter MUST include appId; pass conditionalFields, then .find().
+const BOOKING_APP_ID = "13d21c63-b5ec-5912-8397-c3a5ddb27a97";
+const { items } = await wix.services.queryServices({
+  query: { filter: { appId: BOOKING_APP_ID }, paging: { limit: 100 } },
+  conditionalFields: ["STAFF_MEMBER_DETAILS"],
+}).find();
+const visible = items.filter((s) => !s.hidden);
+// name s.name · tagline s.tagLine · slug s.mainSlug?.name ·
+// duration s.schedule?.availabilityConstraints?.sessionDurations?.[0] ·
+// price s.payment?.fixed?.price ({ value, currency } — value is a string).
+```
 
+## Availability (week calendar)
+Render a **week calendar** (day strip → the day's times), not a flat grid — see
+`../../bookings/FLOW.md` § 5. `fromLocalDate`/`toLocalDate` are **local** strings
+(`YYYY-MM-DDThh:mm:ss`, no `Z`) + a `timeZone`.
+```js
+// APPOINTMENT — serviceId is a single GUID STRING:
+const a = await wix.availabilityTimeSlots.listAvailabilityTimeSlots({ serviceId, fromLocalDate, toLocalDate, timeZone, bookable: true, cursorPaging: { limit: 100 } });
+// slots a.timeSlots[] — localStartDate/localEndDate/scheduleId at the TOP level.
 // CLASS — different namespace, PLURAL serviceIds; slots carry eventInfo.eventId, no scheduleId:
-const c = await wix.eventTimeSlots.listEventTimeSlots({
-  serviceIds: [serviceId], fromLocalDate, toLocalDate, timeZone, includeNonBookable: false,
-});
+const c = await wix.eventTimeSlots.listEventTimeSlots({ serviceIds: [serviceId], fromLocalDate, toLocalDate, timeZone, includeNonBookable: false });
 ```
 
-`fromLocalDate`/`toLocalDate` are **local** date strings (`YYYY-MM-DDThh:mm:ss`, no `Z`) with an explicit `timeZone`.
-
-## Book — redirect to Wix-hosted bookings checkout
-
-Same pattern as the ecom guide's hosted checkout: create a redirect session for the chosen slot and send the visitor to Wix.
-
+## Booking form — schema-driven
+The booking form is a `@wix/forms` form on the service (`service.form._id`). Read
+its schema and render fields by `componentType`, collecting values keyed by
+`target` (`../../bookings/FLOW.md` § 4):
 ```js
-import { redirects } from "https://esm.sh/@wix/redirects@1"; // register in modules
-
-const { redirectSession } = await wix.redirects.createRedirectSession({
-  bookingsCheckout: {
-    slotAvailability: {
-      slot: {
-        serviceId: slot.serviceId,
-        scheduleId: slot.scheduleId,        // APPOINTMENT slots
-        startDate: slot.localStartDate,
-        endDate: slot.localEndDate,
-        timezone: timeZone,
-      },
-    },
-    timezone: timeZone,
-  },
-  callbacks: { postFlowUrl: window.location.href }, // return to the brought-in site after checkout
-});
-window.location.href = redirectSession.fullUrl;
+const { form } = await wix.forms.getForm(service.form._id);
+const RENDERABLE = ["TEXT_INPUT", "PHONE_INPUT", "DROPDOWN"];
+const fields = (form.formFields ?? []).filter(
+  (f) => f.fieldType === "INPUT" && !f.hidden &&
+         RENDERABLE.includes(f.inputOptions?.stringOptions?.componentType),
+);
+// render each by f.inputOptions.stringOptions.componentType; collect values by f.inputOptions.target.
+// SKIP complex object-valued fields (e.g. multi-line ADDRESS, no string componentType) —
+// sending a string for them fails createBooking with "must be object". Only
+// first_name/last_name/email are enforced, so skipping optional complex fields is safe.
 ```
 
-The hosted flow collects contact details, takes payment when the service is paid, **confirms the booking (holds the seat)**, and sends the customer email — none of which the client site has to implement.
-
-> **CLASS sessions:** the verified `slotAvailability.slot` shape above is the APPOINTMENT one. For a CLASS service, slots come from `eventTimeSlots` with `eventInfo.eventId` and no `scheduleId` — verify the class slot→redirect mapping against the redirects SDK docs at wiring time before wiring a CLASS service; don't guess the shape.
+## Book — the ecom Cart V2 sequence
+Mirror `../../astro/templates/bookings/bookingDriver.ts` (the exact payloads).
+Run the same sequence through `wix.*`; the cart holds the seat, so no elevation.
+```js
+const BOOKING_APP_ID = "13d21c63-b5ec-5912-8397-c3a5ddb27a97";
+const STAFF_MEMBER_RESOURCE_TYPE_ID = "1cd44cf8-756f-41c3-bd90-3e2ffcaf1155";
+
+// Build the slot. APPOINTMENT carries scheduleId; CLASS carries eventId (Wix
+// derives the rest). No staff chosen → the ANY_RESOURCE fallback.
+const slot =
+  slotType === "CLASS"
+    ? { serviceId, eventId, timezone }
+    : {
+        serviceId, scheduleId, startDate, endDate, timezone,
+        resourceSelections: [{ resourceTypeId: STAFF_MEMBER_RESOURCE_TYPE_ID, selectionMethod: "ANY_RESOURCE" }],
+        location: { locationType: "OWNER_BUSINESS" },
+      };
+
+// selectedPaymentOption must match the service: online-only → ONLINE,
+// in-person-only → OFFLINE, else ONLINE. DERIVE it — do not hardcode ONLINE: a
+// free / pay-in-person service booked ONLINE is rejected by the cart with
+// INSUFFICIENT_INVENTORY (it's the only service kind that reaches placeOrder).
+const o = service.payment?.options;
+const selectedPaymentOption =
+  o?.online && !o?.inPerson ? "ONLINE" : !o?.online && o?.inPerson ? "OFFLINE" : "ONLINE";
+
+// 1. createBooking → CREATED. Arg 1 is the BOOKING object (slot nested under
+//    bookedEntity); formSubmission/sendSmsReminder go in the options arg.
+const { booking } = await wix.bookings.createBooking(
+  { selectedPaymentOption, totalParticipants: 1, bookedEntity: { slot } },
+  { formSubmission, sendSmsReminder: true }, // formSubmission keyed by each field's `target`
+);
+// 2. createCart — one catalog item per booking._id, catalogReference.appId = BOOKING_APP_ID, channel WEB.
+const cart = await wix.createCart({ catalogItems: [{ quantity: 1, catalogReference: { catalogItemId: booking._id, appId: BOOKING_APP_ID } }], cart: { source: { channelType: "WEB" } } });
+// 3. calculateCart → { cart, summary }, then compute the checkout decision.
+const { cart: calc, summary } = await wix.calculateCart(cart._id);
+const checkoutRequired =
+  service.bookingPolicy?.cancellationFeePolicy?.enabled
+    ? true
+    : Number(summary?.priceSummary?.total?.amount ?? 0) === 0
+      ? false
+      : calc?.lineItems?.[0]?.paymentConfig?.paymentOption !== "FULL_PAYMENT_OFFLINE";
+// 4. paid → redirect (ecomCheckout.checkoutId = cartId) ; free/offline → placeOrder.
+if (checkoutRequired) {
+  const { redirectSession } = await wix.redirects.createRedirectSession({ ecomCheckout: { checkoutId: cart._id }, callbacks: { postFlowUrl: window.location.href } });
+  window.location.href = redirectSession.fullUrl;
+} else {
+  await wix.placeOrder(cart._id); // booked — no redirect
+}
+```
 
-## Deferred (needs the server runtime — `@wix/astro`)
+> Confirm the `@wix/auto_sdk_ecom_cart-v-2` function registration shape on a
+> CDN/own client at wiring time; the payloads above match the astro `bookingDriver.ts`.
 
-On-site booking flow (calendar + form + elevated `confirmBooking` seat-hold), manage/cancel via anonymous action tokens, and the native waitlist (v1, Manage Bookings scope) — all implemented in the astro vertical (`references/astro/bookings/`); out of scope for client-only integration.
+## Out of v1
+Waitlist and on-site manage/cancel — out of scope (same as the astro vertical).
+Show bookable slots only; post-booking self-service is handled by the Wix-hosted
+flow / member area.

package/skills/wix-headless/references/verticals/bookings.md

@@ -6,13 +6,11 @@ requires: []
 
 features:
   - name: "Services catalog"
-    description: "Browse bookable services (appointments or group classes) with descriptions, duration, pricing, and instructor info."
+    description: "Browse bookable appointment services with descriptions, duration, and pricing."
   - name: "Online booking"
-    description: "Pick an available time slot, complete a booking form, and receive confirmation — all without leaving your site."
-  - name: "Group classes"
-    description: "Capacity-aware class sign-up with party size, the leading instructor per session, and a waitlist when a session is full."
-  - name: "Manage booking"
-    description: "View and cancel a booking from the confirmation page or a shared manage link, no account login required."
+    description: "Pick an available time slot on a calendar, complete the service's booking form, and confirm."
+  - name: "Secure checkout"
+    description: "Free or pay-in-person bookings confirm instantly; paid services hand off to Wix's secure hosted checkout."
 
 apps:
   - name: "Wix Bookings"
@@ -24,8 +22,8 @@ routes:
     name: "Service Detail"
   - route: "/booking-confirmation"
     name: "Booking Confirmation"
-  - route: "/manage-booking"
-    name: "Manage Booking"
+  - route: "Hosted by Wix"
+    name: "Secure Checkout"
 
 disabled: false
 ---

package/skills/wix-manage/SKILL.md

@@ -52,6 +52,18 @@ These recipes do NOT cover frontend development or SDK usage for displaying data
 ### [Create and Update Booking Services](references/bookings/create-and-update-booking-services.md)
 **Technical:** Full CRUD operations for Wix Bookings services using Services API. Covers service types (APPOINTMENT, CLASS, COURSE), pricing configuration, location setup, and schedule management.
 
+### [Create Booking Service from Prompt](references/bookings/create-booking-service-from-prompt.md)
+**Technical:** Use when the user wants to create a booking service — e.g. "create a yoga class for $50", "set up consultations", "add a personal training appointment". Routes to the correct type-specific recipe (APPOINTMENT, CLASS, or COURSE), gathers business context, applies defaults, and creates the service.
+
+### [Create Appointment Service](references/bookings/create-appointment-service.md)
+**Technical:** Use when the user wants to create an appointment/consultation/1-on-1 service — e.g. "set up consultations for $75", "create a meeting service". Handles staff assignment, session duration, and pricing via bulkCreateServices API.
+
+### [Create Class Service](references/bookings/create-class-service.md)
+**Technical:** Use when the user wants to create a group class — e.g. "create a yoga class for $50", "set up a pilates class". Handles group capacity, recurring sessions, and pricing via bulkCreateServices API.
+
+### [Create Course Service](references/bookings/create-course-service.md)
+**Technical:** Use when the user wants to create a multi-session course — e.g. "create a 6-week workshop", "set up a training program for $300". Handles group capacity, full-course pricing, and fixed series via bulkCreateServices API.
+
 ### [End-to-End Booking Flow](references/bookings/end-to-end-booking-flow.md)
 **Technical:** Complete booking flow from service discovery to payment. Query services, check availability with Time Slots V2, create bookings, and process payment via eCommerce checkout.
 

package/skills/wix-manage/references/app-installation/install-wix-apps.md

@@ -4,7 +4,7 @@ description: Installs Wix apps on a site using Apps Installer API. Covers enabli
 ---
 # Install Wix Apps on a Site
 
-This recipe guides you through installing Wix apps on a site using the Apps Installer REST API, including enabling Velo (Wix Code) when needed.
+This recipe guides you through installing Wix apps on a site using the Apps Installer REST API.
 
 ## Prerequisites
 
@@ -51,30 +51,8 @@ Use the returned `appId` as the `appDefId` in Step 2.
 - The `appDefId` field in the install request and the `appId` field returned here are the same value
 - If multiple results come back, match on `basicInfo.name` to confirm you have the right app before installing
 - Only listings with `status: "PUBLISHED"` can be installed
-## Step 1: Enable Velo (Wix Code) if Needed
 
-If you receive the error `WDE0110: Wix Code not enabled`, you must first enable Velo on the site.
-
-**Endpoint**: `POST https://www.wixapis.com/mcp-serverless/v1/velo/provision`
-
-**Request**:
-```bash
-curl -X POST \
-  'https://www.wixapis.com/mcp-serverless/v1/velo/provision/' \
-  -H 'Authorization: <AUTH>' \
-  -H 'Content-Type: application/json' \
-  -d '{}'
-```
-
-**Response**: Empty body on success.
-
-### IMPORTANT NOTES:
-- Only call this endpoint if you receive the `WDE0110` error
-- This is a one-time operation per site
-
----
-
-## Step 2: Install the Wix App
+## Install the Wix App
 
 Use the Apps Installer API to install any Wix app on a site.
 
@@ -122,6 +100,7 @@ Some common apps:
 | Wix Blog | `14bcded7-0066-7c35-14d7-466cb3f09103` |
 | Wix Events | `140603ad-af8d-84a5-2c80-a0f60cb47351` |
 | Wix Pricing Plans | `1522827f-c56c-a5c9-2ac9-00f9e6ae12d3` |
+| Wix CMS | `e593b0bd-b783-45b8-97c2-873d42aacaf4` |
 
 ### IMPORTANT NOTES:
 - NEVER guess the `appDefId`. For Wix-built apps, use the table above. For any other app, resolve the ID using Step 0 (Search Market Listings).
@@ -135,9 +114,6 @@ Some common apps:
 ### App Not Installed Error
 If you receive an error indicating a required app is not installed, use this recipe to install it before proceeding.
 
-### WDE0110: Wix Code not enabled
-Call the Velo provision endpoint (Step 1) first, then retry the original operation.
-
 ---
 
 ## Next Steps

package/skills/wix-manage/references/bookings/create-appointment-service.md

@@ -0,0 +1,266 @@
+---
+name: "Create Appointment Service"
+description: "Create an appointment booking service — e.g. 'set up consultations', 'create a 1-on-1 session', 'add a personal training appointment', 'create a meeting service for $25'. Handles staff assignment (required), session duration, pricing, and 1-on-1 capacity defaults via bulkCreateServices API."
+---
+
+# Create Appointment Service from Prompt
+
+## When to Use
+
+- User wants to create an appointment-based service: "set up consultations", "create a 1-on-1 session", "add a personal training appointment", "create a meeting service"
+- The service type is APPOINTMENT — customer picks an available time slot during staff working hours
+- For general service creation where the type is ambiguous, see [Create Booking Service from Prompt](./create-booking-service-from-prompt.md)
+
+## Prerequisites
+
+- **Wix Bookings app installed** (App ID: `13d21c63-b5ec-5912-8397-c3a5ddb27a97`). Use [List Installed Apps](../app-installation/list-installed-apps.md) to verify, and [Install Wix Apps](../app-installation/install-wix-apps.md) to install if missing.
+- For full API field definitions, validation rules, and troubleshooting, see [Create and Update Booking Services](./create-and-update-booking-services.md)
+
+---
+
+## Step 1: Gather Business Context
+
+Run these queries to collect site data for informed defaults.
+
+### 1a. Query Staff Members (CRITICAL for Appointments)
+
+```bash
+curl -X POST 'https://www.wixapis.com/bookings/v1/staff-members/query' \
+  -H 'Authorization: <AUTH>' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "query": {},
+    "fields": ["RESOURCE_DETAILS"]
+  }'
+```
+
+Save each staff member's `resourceId` (not `id`). Note which one has `default: true`.
+
+**APPOINTMENT services REQUIRE at least one staff member.** If no staff members exist, create one first using [Bookings Staff Setup](./bookings-staff-setup.md).
+
+### 1b. Query Service Categories
+
+```bash
+curl -X POST 'https://www.wixapis.com/bookings/v2/categories/query' \
+  -H 'Authorization: <AUTH>' \
+  -H 'Content-Type: application/json' \
+  -d '{ "query": {} }'
+```
+
+### 1c. Get Site Currency
+
+```bash
+curl -X GET 'https://www.wixapis.com/site-properties/v4/properties' \
+  -H 'Authorization: <AUTH>'
+```
+
+Extract `properties.paymentCurrency`. Fall back to `USD` if unavailable.
+
+### 1d. Query Existing Services (Duplicate Check)
+
+```bash
+curl -X POST 'https://www.wixapis.com/bookings/v2/services/query' \
+  -H 'Authorization: <AUTH>' \
+  -H 'Content-Type: application/json' \
+  -d '{ "query": { "paging": { "limit": 100 } } }'
+```
+
+Warn the user if a service with a similar name already exists.
+
+---
+
+## Step 2: Apply Appointment Defaults
+
+For any fields the user did not explicitly specify:
+
+| Field | Default | Notes |
+|---|---|---|
+| Duration | 60 minutes | Set via `schedule.availabilityConstraints.sessionDurations` |
+| Capacity | 1 | Appointments are typically 1-on-1 |
+| Staff | Auto-assign | Use `default: true` staff, or first available |
+| Online booking | Enabled | `onlineBooking.enabled: true` |
+
+### Pricing (if not specified)
+
+- Use the site's currency from Step 1c
+- If user specifies a price → `rateType: "FIXED"`
+- If user says "free" → `rateType: "NO_FEE"`, `options.inPerson: true`, `options.online: false`
+- If no price mentioned → infer from context (consultations ~$50-100, sessions ~$30-60) or default to free
+
+### Staff Assignment
+
+- **1 staff member** → auto-assign using their `resourceId`
+- **Multiple staff members** → use the one with `default: true`, or the first one
+- **No staff members** → create one first using [Bookings Staff Setup](./bookings-staff-setup.md), then proceed
+
+### Category
+
+- If categories exist → assign the most relevant one
+- If no categories exist → create a "General" category:
+```bash
+curl -X POST 'https://www.wixapis.com/bookings/v2/categories' \
+  -H 'Authorization: <AUTH>' \
+  -H 'Content-Type: application/json' \
+  -d '{ "category": { "name": "General" } }'
+```
+
+### Service Name & Description
+
+- Use the user's wording for the service name
+- Generate a brief, professional description (1-2 sentences)
+
+---
+
+## Step 3: Create the Appointment Service
+
+**Paid appointment:**
+
+```bash
+curl -X POST 'https://www.wixapis.com/bookings/v2/bulk/services/create' \
+  -H 'Authorization: <AUTH>' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "services": [{
+      "name": "<SERVICE_NAME>",
+      "description": "<GENERATED_DESCRIPTION>",
+      "type": "APPOINTMENT",
+
+      "onlineBooking": { "enabled": true },
+      "staffMemberIds": ["<RESOURCE_ID>"],
+      "schedule": {
+        "availabilityConstraints": {
+          "sessionDurations": [<DURATION_MINUTES>]
+        }
+      },
+      "payment": {
+        "rateType": "FIXED",
+        "options": { "online": true, "inPerson": false },
+        "fixed": {
+          "price": { "value": "<PRICE>", "currency": "<CURRENCY>" }
+        }
+      },
+      "category": {
+        "id": "<CATEGORY_ID>"
+      }
+    }]
+  }'
+```
+
+**Free appointment:**
+
+```bash
+curl -X POST 'https://www.wixapis.com/bookings/v2/bulk/services/create' \
+  -H 'Authorization: <AUTH>' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "services": [{
+      "name": "<SERVICE_NAME>",
+      "description": "<GENERATED_DESCRIPTION>",
+      "type": "APPOINTMENT",
+
+      "onlineBooking": { "enabled": true },
+      "staffMemberIds": ["<RESOURCE_ID>"],
+      "schedule": {
+        "availabilityConstraints": {
+          "sessionDurations": [<DURATION_MINUTES>]
+        }
+      },
+      "payment": {
+        "rateType": "NO_FEE",
+        "options": { "online": false, "inPerson": true }
+      },
+      "category": {
+        "id": "<CATEGORY_ID>"
+      }
+    }]
+  }'
+```
+
+### APPOINTMENT-Specific Reminders
+
+- `staffMemberIds` is **required** — uses `resourceId` values, not staff member `id`
+- `schedule.availabilityConstraints.sessionDurations` sets the appointment length
+- Availability is based on the assigned staff member's working hours schedule
+
+Save the `serviceId` from the response: `results[0].item.service.id`
+
+---
+
+## Step 4: Navigate to Service Form
+
+Use the **RUN_IN_BROWSER** tool to navigate the user to the service form for final review:
+
+```javascript
+window.location.href = `/bookings/services/form/${serviceId}?fromAria=true`;
+```
+
+This executes in the user's browser and redirects them to the service editing page.
+
+---
+
+## Step 5: Summary Message
+
+Provide a summary including:
+
+1. **What was created** — service name, price, duration, assigned staff member
+2. **Assumptions made** — list defaults used (e.g., "I set the duration to 60 minutes since you didn't specify")
+3. **Next steps** — "Click Save to finalize, then set up your availability"
+4. **Offer to adjust** — "Want me to change the price, duration, or staff assignment?"
+
+**Example:**
+
+> I created **"Strategy Consultation"**:
+>
+> - **Type**: Appointment (1-on-1)
+> - **Price**: $75 per session
+> - **Duration**: 60 minutes
+> - **Staff**: Assigned to Sarah Johnson
+> - **Category**: Consulting
+>
+> I assumed a 60-minute duration since you didn't specify. You can review and adjust the details in the service form.
+
+---
+
+## Error Handling
+
+| Error | Cause | Action |
+|---|---|---|
+| 428 "App not installed" | Bookings not installed | Install using [Install Wix Apps](../app-installation/install-wix-apps.md) |
+| 400 "staffMemberIds required" | No staff assigned | Query staff; if none exist, create one via [Bookings Staff Setup](./bookings-staff-setup.md) |
+| 400 "INVALID_PAYMENT_OPTIONS" | Payment misconfigured | Free: `inPerson: true`, `online: false`. Paid: price > 0 |
+| 403 | Permission denied | Inform user they lack permission |
+
+---
+
+## Payment Validation Quick Reference
+
+| rateType | `options.online` | `options.inPerson` | Valid? |
+|----------|------------------|-------------------|--------|
+| FIXED    | true             | false             | ✓      |
+| FIXED    | false            | true              | ✓      |
+| FIXED    | true             | true              | ✓      |
+| NO_FEE   | false            | true              | ✓      |
+| NO_FEE   | true             | false             | ✗      |
+| Any      | false            | false             | ✗      |
+
+---
+
+## What This Skill Does NOT Cover
+
+- **Schedule/availability setup** — staff working hours need separate configuration. See [Bookings Staff Setup](./bookings-staff-setup.md)
+- **Pricing plans** — memberships and session packs are separate. See [Create and Update Pricing Plans](../pricing-plans/create-and-update-pricing-plans.md)
+- **Service images** — requires Media Manager API (see [create-and-update-booking-services.md](./create-and-update-booking-services.md))
+
+---
+
+## API Documentation Reference
+
+- [Bulk Create Services](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/bulk-create-services)
+- [Query Services](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/query-services)
+- [Query Categories](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/categories-v2/query-categories)
+- [Create Category](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/categories-v2/create-category)
+- [Query Staff Members](https://dev.wix.com/docs/api-reference/business-solutions/bookings/staff-members/staff-members/query-staff-members)
+- [Create Staff Member](https://dev.wix.com/docs/api-reference/business-solutions/bookings/staff-members/staff-members/create-staff-member)
+- [Site Properties](https://dev.wix.com/docs/api-reference/business-management/site-management/site-properties/properties/read)
+- [About Service Types](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/about-service-types)
+- [About Service Payments](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/about-service-payments)

package/skills/wix-manage/references/bookings/create-booking-service-from-prompt.md

@@ -0,0 +1,37 @@
+---
+name: "Create Booking Service from Prompt"
+description: "Create a booking service from a user prompt — e.g. 'create a yoga class for $50', 'set up consultations for $75', 'add a personal training appointment', 'create a 6-week photography workshop'. Determines the service type (APPOINTMENT, CLASS, or COURSE) and delegates to the type-specific recipe."
+---
+
+# Create Booking Service from Natural Language Prompt
+
+## When to Use
+
+- User describes a service they want to create using natural language (e.g., "create a yoga class for $50", "set up consultation sessions", "add a personal training appointment")
+- The intent is autonomous creation — fill in reasonable defaults rather than asking the user for every field
+
+## Prerequisites
+
+- **Wix Bookings app installed** (App ID: `13d21c63-b5ec-5912-8397-c3a5ddb27a97`)
+- If Bookings is not installed, use [Install Wix Apps](../app-installation/install-wix-apps.md) to install it first
+
+---
+
+## Step 1: Determine Service Type
+
+| User mentions | Type | Recipe |
+|---|---|---|
+| consultation, appointment, meeting, 1-on-1, one-on-one, session | `APPOINTMENT` | [Create Appointment Service](./create-appointment-service.md) |
+| class, yoga, pilates, group session, group workout, bootcamp class | `CLASS` | [Create Class Service](./create-class-service.md) |
+| workshop, program, course, training program, multi-session | `COURSE` | [Create Course Service](./create-course-service.md) |
+| (unclear or unspecified) | `APPOINTMENT` | [Create Appointment Service](./create-appointment-service.md) |
+
+## Step 2: Follow the Type-Specific Recipe
+
+Once the service type is determined, follow the corresponding recipe linked above. Each recipe covers:
+
+1. Gathering business context (staff, categories, currency, duplicate check)
+2. Applying type-specific defaults (pricing, capacity, duration, staff assignment)
+3. Creating the service via `bulkCreateServices`
+4. Navigating to the service form for user review
+5. Providing a summary of what was created and assumptions made