@wix/agent-skills 1.1.0 → 1.3.0

package/README.md

@@ -55,16 +55,6 @@ npx skills add wix/skills
 npx skills add wix/skills -g
 ```
 
-### npm Package (versioned distribution)
-
-For Wix-internal infrastructure that needs a pinned, versioned skills snapshot (e.g., App Builder, Studio 2, `@wix/cli`), `@wix/agent-skills` is also published to npm:
-
-```bash
-npm install @wix/agent-skills
-```
-
-The npm package contains the same skill bodies as the GitHub repo but pinned to a specific version. Consumers typically install it as a transitive dependency of `@wix/cli` rather than directly. See [CODEAI-505](https://wix.atlassian.net/browse/CODEAI-505) for context.
-
 ## Available Skills
 
 | Skill                                    | Purpose                          | When to Use                                                                                                                         |
@@ -100,7 +90,7 @@ When a major bump is required (a breaking change in the underlying `wix-cli`), t
 
 ## Releasing
 
-Releases run via the [`release` GitHub Actions workflow](.github/workflows/release.yml) using npm Trusted Publishing (no stored tokens). Triggered manually from the **Actions** tab: pick `version_strategy` and optionally `dry_run`. Modeled on [`wix/interact`](https://github.com/wix/interact/blob/master/.github/workflows/release-interact.yml)'s setup.
+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,8 +1,12 @@
 {
   "name": "@wix/agent-skills",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "Wix Skills for AI coding agents — versioned npm distribution of the wix/skills content.",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wix/skills.git"
+  },
   "homepage": "https://github.com/wix/skills",
   "bugs": {
     "url": "https://github.com/wix/skills/issues"
@@ -12,18 +16,8 @@
     "README.md",
     "LICENSE"
   ],
-  "scripts": {
-    "test": "echo \"no tests\" && exit 0"
-  },
   "publishConfig": {
-    "registry": "https://registry.npmjs.org/",
-    "access": "public"
-  },
-  "wix": {
-    "artifact": {
-      "groupId": "com.wixpress.npm",
-      "artifactId": "agent-skills"
-    }
-  },
-  "falconPackageHash": "33bdd30a5288c55232a069b39e440161731b5a6ee3d8d8ba288f1806"
-}
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}

package/skills/wix-app/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: wix-app
 description: "Build and review Wix CLI app extensions — dashboard pages, modals, plugins, menu plugins, custom element widgets, Editor React components, site plugins, embedded scripts, backend APIs, backend events, service plugins, data collections, and App Market readiness. Use when building ANY feature or extension for a Wix CLI app or preparing a Wix app for App Market review. Triggers on: add, build, create, implement, help me, dashboard, widget, plugin, backend, API, event, collection, embedded script, service plugin, Editor React component, checkout, shipping, tax, discount, SPI, CMS, schema, tracking, popup, admin panel, menu item, modal, validate, test, verify, register extension, App Market, app review, submission readiness."
-compatibility: Requires Wix CLI development environment
+compatibility: Requires Wix CLI development environment.
 ---
 
 # Wix App Builder

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>'
 ```