@wix/agent-skills 1.2.0 → 1.3.0

package/README.md

@@ -90,7 +90,7 @@ When a major bump is required (a breaking change in the underlying `wix-cli`), t
 
 ## Releasing
 
-Run the [`release-bump`](.github/workflows/release-bump.yml) workflow from the **Actions** tab and pick a `version_strategy`. Review and merge the PR it opens — [`release.yml`](.github/workflows/release.yml) then publishes to npm via Trusted Publishing.
+Run the [`release-bump`](.github/workflows/release-bump.yml) workflow from the **Actions** tab and pick a `version_strategy`. The rest is automatic — the bump PR auto-merges once checks pass and [`release.yml`](.github/workflows/release.yml) publishes to npm via Trusted Publishing.
 
 ## Contributing
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/agent-skills",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Wix Skills for AI coding agents — versioned npm distribution of the wix/skills content.",
   "license": "MIT",
   "repository": {

package/skills/wix-manage/references/cms/cms-data-items-crud.md

@@ -23,8 +23,10 @@ This recipe covers basic Create, Read, Update, Delete (CRUD) operations for Wix
 Before inserting or updating items, you need to know the collection's field names and types. If you don't already know the schema:
 
 1. **Query existing items** - Fetch a few items to infer field names from the data
-2. **Get collection schema** - Use `GET /collections/{collectionId}` for full field definitions
-3. **List collections** - Use `GET /collections?fields=id` to see what collections exist (see [Schema Management](cms-schema-management.md))
+2. **Get collection schema** - Use `GET /collections/{dataCollectionId}` for full field definitions
+3. **List collections** - Use `GET /collections?fields=displayName` to see what collections exist (see [Schema Management](cms-schema-management.md))
+
+It may be, that user refers to schema by its `displayName` rather than `id`, if collection is not found list all collections to find the right `id` (`dataCollectionId`) to use.
 
 ---
 
@@ -351,6 +353,28 @@ curl -X DELETE \
 }
 ```
 
+## Field Types Reference
+
+| Type | Description | Example Value |
+|------|-------------|---------------|
+| `TEXT` | String | `"Hello World"` |
+| `NUMBER` | Numeric | `99.99` |
+| `BOOLEAN` | True/false | `true` |
+| `DATE` | Date only | `"2024-01-15"` |
+| `DATETIME` | Date and time | `{ "$date": "2024-01-15T10:00:00.000Z" }` |
+| `IMAGE` | Image reference (HTTP url or wix:image://v1/{mediaId}/{friendlyName}) | `"wix:image://v1/3f72369f2219e2ee853e9e3df0217ce1.jpg/Colorful%20Business%20Cards.jpg"` |
+| `VIDEO` | Video reference (HTTP url or wix:video://v1/{mediaId}/{friendlyName}) | `"wix:video://v1/11062b_484182533ede4b9a81329daf20238867/Sketching%20Design%20Concepts#posterUri=11062b_484182533ede4b9a81329daf20238867f000.jpg&posterWidth=1920&posterHeight=1080"` |
+| `DOCUMENT` | Document reference  (HTTP url or wix:document://v1/{mediaId}) | `"wix:document://v1/..."` |
+| `URL` | Web URL | `"https://example.com"` |
+| `RICH_TEXT` | HTML content | `"<p>Rich text</p>"` |
+| `EMAIL` | Email | `"example@wix.com"` |
+| `RICH_CONTENT` | Structured content | Complex object |
+| `ADDRESS` | Address object | Address fields |
+| `ARRAY_STRING` | Array of strings | `["tag1", "tag2"]` |
+| `OBJECT` | JSON object | `{"key": "value"}` |
+| `REFERENCE` | Single reference | Item ID string |
+| `MULTI_REFERENCE` | Multiple references, use separate *reference* endpoints to manipulate, `include` to include in queries | Array of IDs |
+
 ---
 
 ## Query Operators

package/skills/wix-manage/references/cms/cms-schema-management.md

@@ -20,7 +20,7 @@ This recipe covers managing the structure (schema) of Wix CMS collections using
 **Lightweight listing (recommended for existence checks)**:
 ```bash
 curl -X GET \
-'https://www.wixapis.com/wix-data/v2/collections?fields=id' \
+'https://www.wixapis.com/wix-data/v2/collections?fields=displayName' \
 -H 'Authorization: <AUTH>'
 ```