@wix/agent-skills 1.10.0 → 1.11.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +4 -1
- package/skills/wix-manage/references/bookings/create-appointment-service.md +2 -15
- package/skills/wix-manage/references/bookings/create-booking-service-from-prompt.md +1 -8
- package/skills/wix-manage/references/bookings/create-class-service.md +2 -15
- package/skills/wix-manage/references/bookings/create-course-service.md +2 -15
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@wix/agent-skills",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.11.0",
|
|
4
4
|
"description": "Wix Skills for AI coding agents — versioned npm distribution of the wix/skills content.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"repository": {
|
|
@@ -11,6 +11,9 @@
|
|
|
11
11
|
"bugs": {
|
|
12
12
|
"url": "https://github.com/wix/skills/issues"
|
|
13
13
|
},
|
|
14
|
+
"scripts": {
|
|
15
|
+
"version": "node .github/scripts/sync-plugin-versions.mjs && git add .claude-plugin/plugin.json .codex-plugin/plugin.json .cursor-plugin/plugin.json plugin.json gemini-extension.json"
|
|
16
|
+
},
|
|
14
17
|
"files": [
|
|
15
18
|
"skills/**",
|
|
16
19
|
"README.md",
|
|
@@ -13,7 +13,6 @@ description: "Create an appointment booking service — e.g. 'set up consultatio
|
|
|
13
13
|
|
|
14
14
|
## Prerequisites
|
|
15
15
|
|
|
16
|
-
- **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.
|
|
17
16
|
- For full API field definitions, validation rules, and troubleshooting, see [Create and Update Booking Services](./create-and-update-booking-services.md)
|
|
18
17
|
|
|
19
18
|
---
|
|
@@ -47,16 +46,7 @@ curl -X POST 'https://www.wixapis.com/bookings/v2/categories/query' \
|
|
|
47
46
|
-d '{ "query": {} }'
|
|
48
47
|
```
|
|
49
48
|
|
|
50
|
-
### 1c.
|
|
51
|
-
|
|
52
|
-
```bash
|
|
53
|
-
curl -X GET 'https://www.wixapis.com/site-properties/v4/properties' \
|
|
54
|
-
-H 'Authorization: <AUTH>'
|
|
55
|
-
```
|
|
56
|
-
|
|
57
|
-
Extract `properties.paymentCurrency`. Fall back to `USD` if unavailable.
|
|
58
|
-
|
|
59
|
-
### 1d. Query Existing Services (Duplicate Check)
|
|
49
|
+
### 1c. Query Existing Services (Duplicate Check)
|
|
60
50
|
|
|
61
51
|
```bash
|
|
62
52
|
curl -X POST 'https://www.wixapis.com/bookings/v2/services/query' \
|
|
@@ -82,7 +72,6 @@ For any fields the user did not explicitly specify:
|
|
|
82
72
|
|
|
83
73
|
### Pricing (if not specified)
|
|
84
74
|
|
|
85
|
-
- Use the site's currency from Step 1c
|
|
86
75
|
- If user specifies a price → `rateType: "FIXED"`
|
|
87
76
|
- If user says "free" → `rateType: "NO_FEE"`, `options.inPerson: true`, `options.online: false`
|
|
88
77
|
- If no price mentioned → infer from context (consultations ~$50-100, sessions ~$30-60) or default to free
|
|
@@ -136,7 +125,7 @@ curl -X POST 'https://www.wixapis.com/bookings/v2/bulk/services/create' \
|
|
|
136
125
|
"rateType": "FIXED",
|
|
137
126
|
"options": { "online": true, "inPerson": false },
|
|
138
127
|
"fixed": {
|
|
139
|
-
"price": { "value": "<PRICE>"
|
|
128
|
+
"price": { "value": "<PRICE>" }
|
|
140
129
|
}
|
|
141
130
|
},
|
|
142
131
|
"category": {
|
|
@@ -213,7 +202,6 @@ Provide a summary including:
|
|
|
213
202
|
|
|
214
203
|
| Error | Cause | Action |
|
|
215
204
|
|---|---|---|
|
|
216
|
-
| 428 "App not installed" | Bookings not installed | Install using [Install Wix Apps](../app-installation/install-wix-apps.md) |
|
|
217
205
|
| 400 "staffMemberIds required" | No staff assigned | Query staff; if none exist, create one via [Bookings Staff Setup](./bookings-staff-setup.md) |
|
|
218
206
|
| 400 "INVALID_PAYMENT_OPTIONS" | Payment misconfigured | Free: `inPerson: true`, `online: false`. Paid: price > 0 |
|
|
219
207
|
| 403 | Permission denied | Inform user they lack permission |
|
|
@@ -249,6 +237,5 @@ Provide a summary including:
|
|
|
249
237
|
- [Create Category](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/categories-v2/create-category)
|
|
250
238
|
- [Query Staff Members](https://dev.wix.com/docs/api-reference/business-solutions/bookings/staff-members/staff-members/query-staff-members)
|
|
251
239
|
- [Create Staff Member](https://dev.wix.com/docs/api-reference/business-solutions/bookings/staff-members/staff-members/create-staff-member)
|
|
252
|
-
- [Site Properties](https://dev.wix.com/docs/api-reference/business-management/site-management/site-properties/properties/read)
|
|
253
240
|
- [About Service Types](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/about-service-types)
|
|
254
241
|
- [About Service Payments](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/about-service-payments)
|
|
@@ -10,13 +10,6 @@ description: "Create a booking service from a user prompt — e.g. 'create a yog
|
|
|
10
10
|
- 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")
|
|
11
11
|
- The intent is autonomous creation — fill in reasonable defaults rather than asking the user for every field
|
|
12
12
|
|
|
13
|
-
## Prerequisites
|
|
14
|
-
|
|
15
|
-
- **Wix Bookings app installed** (App ID: `13d21c63-b5ec-5912-8397-c3a5ddb27a97`)
|
|
16
|
-
- If Bookings is not installed, use [Install Wix Apps](../app-installation/install-wix-apps.md) to install it first
|
|
17
|
-
|
|
18
|
-
---
|
|
19
|
-
|
|
20
13
|
## Step 1: Determine Service Type
|
|
21
14
|
|
|
22
15
|
| User mentions | Type | Recipe |
|
|
@@ -30,7 +23,7 @@ description: "Create a booking service from a user prompt — e.g. 'create a yog
|
|
|
30
23
|
|
|
31
24
|
Once the service type is determined, follow the corresponding recipe linked above. Each recipe covers:
|
|
32
25
|
|
|
33
|
-
1. Gathering business context (staff, categories,
|
|
26
|
+
1. Gathering business context (staff where required, categories, duplicate check)
|
|
34
27
|
2. Applying type-specific defaults (pricing, capacity, duration, staff assignment)
|
|
35
28
|
3. Creating the service via `bulkCreateServices`
|
|
36
29
|
4. Navigating to the service form for user review
|
|
@@ -14,7 +14,6 @@ description: "Create a class booking service — e.g. 'create a yoga class for $
|
|
|
14
14
|
|
|
15
15
|
## Prerequisites
|
|
16
16
|
|
|
17
|
-
- **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.
|
|
18
17
|
- For full API field definitions, validation rules, and troubleshooting, see [Create and Update Booking Services](./create-and-update-booking-services.md)
|
|
19
18
|
|
|
20
19
|
---
|
|
@@ -32,16 +31,7 @@ curl -X POST 'https://www.wixapis.com/bookings/v2/categories/query' \
|
|
|
32
31
|
-d '{ "query": {} }'
|
|
33
32
|
```
|
|
34
33
|
|
|
35
|
-
### 1b.
|
|
36
|
-
|
|
37
|
-
```bash
|
|
38
|
-
curl -X GET 'https://www.wixapis.com/site-properties/v4/properties' \
|
|
39
|
-
-H 'Authorization: <AUTH>'
|
|
40
|
-
```
|
|
41
|
-
|
|
42
|
-
Extract `properties.paymentCurrency`. Fall back to `USD` if unavailable.
|
|
43
|
-
|
|
44
|
-
### 1c. Query Existing Services (Duplicate Check)
|
|
34
|
+
### 1b. Query Existing Services (Duplicate Check)
|
|
45
35
|
|
|
46
36
|
```bash
|
|
47
37
|
curl -X POST 'https://www.wixapis.com/bookings/v2/services/query' \
|
|
@@ -67,7 +57,6 @@ For any fields the user did not explicitly specify:
|
|
|
67
57
|
|
|
68
58
|
### Pricing (if not specified)
|
|
69
59
|
|
|
70
|
-
- Use the site's currency from Step 1b
|
|
71
60
|
- If user specifies a price → `rateType: "FIXED"` (per session)
|
|
72
61
|
- If user says "free" → `rateType: "NO_FEE"`, `options.inPerson: true`, `options.online: false`
|
|
73
62
|
- If no price mentioned → infer from context (yoga/fitness classes ~$15-30, art/music ~$20-40) or default to free
|
|
@@ -118,7 +107,7 @@ curl -X POST 'https://www.wixapis.com/bookings/v2/bulk/services/create' \
|
|
|
118
107
|
"rateType": "FIXED",
|
|
119
108
|
"options": { "online": true, "inPerson": false },
|
|
120
109
|
"fixed": {
|
|
121
|
-
"price": { "value": "<PRICE>"
|
|
110
|
+
"price": { "value": "<PRICE>" }
|
|
122
111
|
}
|
|
123
112
|
},
|
|
124
113
|
"category": {
|
|
@@ -193,7 +182,6 @@ Provide a summary including:
|
|
|
193
182
|
|
|
194
183
|
| Error | Cause | Action |
|
|
195
184
|
|---|---|---|
|
|
196
|
-
| 428 "App not installed" | Bookings not installed | Install using [Install Wix Apps](../app-installation/install-wix-apps.md) |
|
|
197
185
|
| 400 "INVALID_PAYMENT_OPTIONS" | Payment misconfigured | Free: `inPerson: true`, `online: false`. Paid: price > 0 |
|
|
198
186
|
| 403 | Permission denied | Inform user they lack permission |
|
|
199
187
|
|
|
@@ -228,6 +216,5 @@ Provide a summary including:
|
|
|
228
216
|
- [Query Categories](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/categories-v2/query-categories)
|
|
229
217
|
- [Create Category](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/categories-v2/create-category)
|
|
230
218
|
- [Bulk Create Events](https://dev.wix.com/docs/api-reference/business-management/calendar/events-v3/bulk-create-event)
|
|
231
|
-
- [Site Properties](https://dev.wix.com/docs/api-reference/business-management/site-management/site-properties/properties/read)
|
|
232
219
|
- [About Service Types](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/about-service-types)
|
|
233
220
|
- [About Service Payments](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/about-service-payments)
|
|
@@ -14,7 +14,6 @@ description: "Create a course booking service — e.g. 'create a 6-week photogra
|
|
|
14
14
|
|
|
15
15
|
## Prerequisites
|
|
16
16
|
|
|
17
|
-
- **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.
|
|
18
17
|
- For full API field definitions, validation rules, and troubleshooting, see [Create and Update Booking Services](./create-and-update-booking-services.md)
|
|
19
18
|
|
|
20
19
|
---
|
|
@@ -32,16 +31,7 @@ curl -X POST 'https://www.wixapis.com/bookings/v2/categories/query' \
|
|
|
32
31
|
-d '{ "query": {} }'
|
|
33
32
|
```
|
|
34
33
|
|
|
35
|
-
### 1b.
|
|
36
|
-
|
|
37
|
-
```bash
|
|
38
|
-
curl -X GET 'https://www.wixapis.com/site-properties/v4/properties' \
|
|
39
|
-
-H 'Authorization: <AUTH>'
|
|
40
|
-
```
|
|
41
|
-
|
|
42
|
-
Extract `properties.paymentCurrency`. Fall back to `USD` if unavailable.
|
|
43
|
-
|
|
44
|
-
### 1c. Query Existing Services (Duplicate Check)
|
|
34
|
+
### 1b. Query Existing Services (Duplicate Check)
|
|
45
35
|
|
|
46
36
|
```bash
|
|
47
37
|
curl -X POST 'https://www.wixapis.com/bookings/v2/services/query' \
|
|
@@ -67,7 +57,6 @@ For any fields the user did not explicitly specify:
|
|
|
67
57
|
|
|
68
58
|
### Pricing (if not specified)
|
|
69
59
|
|
|
70
|
-
- Use the site's currency from Step 1b
|
|
71
60
|
- If user specifies a price → `rateType: "FIXED"` (for the entire course)
|
|
72
61
|
- If user says "free" → `rateType: "NO_FEE"`, `options.inPerson: true`, `options.online: false`
|
|
73
62
|
- If no price mentioned → infer from context (workshops ~$100-300, training programs ~$200-500, bootcamps ~$150-400) or default to free
|
|
@@ -120,7 +109,7 @@ curl -X POST 'https://www.wixapis.com/bookings/v2/bulk/services/create' \
|
|
|
120
109
|
"rateType": "FIXED",
|
|
121
110
|
"options": { "online": true, "inPerson": false },
|
|
122
111
|
"fixed": {
|
|
123
|
-
"price": { "value": "<PRICE>"
|
|
112
|
+
"price": { "value": "<PRICE>" }
|
|
124
113
|
}
|
|
125
114
|
},
|
|
126
115
|
"category": {
|
|
@@ -197,7 +186,6 @@ Provide a summary including:
|
|
|
197
186
|
|
|
198
187
|
| Error | Cause | Action |
|
|
199
188
|
|---|---|---|
|
|
200
|
-
| 428 "App not installed" | Bookings not installed | Install using [Install Wix Apps](../app-installation/install-wix-apps.md) |
|
|
201
189
|
| 400 "INVALID_PAYMENT_OPTIONS" | Payment misconfigured | Free: `inPerson: true`, `online: false`. Paid: price > 0 |
|
|
202
190
|
| 403 | Permission denied | Inform user they lack permission |
|
|
203
191
|
|
|
@@ -232,6 +220,5 @@ Provide a summary including:
|
|
|
232
220
|
- [Query Categories](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/categories-v2/query-categories)
|
|
233
221
|
- [Create Category](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/categories-v2/create-category)
|
|
234
222
|
- [Bulk Create Events](https://dev.wix.com/docs/api-reference/business-management/calendar/events-v3/bulk-create-event)
|
|
235
|
-
- [Site Properties](https://dev.wix.com/docs/api-reference/business-management/site-management/site-properties/properties/read)
|
|
236
223
|
- [About Service Types](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/about-service-types)
|
|
237
224
|
- [About Service Payments](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/about-service-payments)
|