@wix/agent-skills 1.0.0

package/skills/wix-app/references/dashboard-plugin/SLOTS.md

@@ -0,0 +1,294 @@
+# Dashboard Plugin Slots Reference
+
+Slots are UI placeholders on dashboard pages of Wix first-party business apps. Each slot has a unique ID used in the `extends` field of a dashboard plugin.
+
+**Key behaviors:**
+- Some slots with the same ID appear on different pages. A plugin targeting such a slot is displayed on all pages containing it.
+- Slots can host multiple plugins. Ordering varies by slot (see each entry).
+
+---
+
+## Wix Blog
+
+### Overview Page
+
+**Slot ID:** `65fae040-bbeb-4c62-ba14-e0ecb5e08661`
+
+- **Dashboard path:** Blog > Overview
+- **Location:** Top of page
+- **Parameters:** None
+- **Multi-plugin:** Vertical, newest at bottom
+- **Use case:** Display blog analytics or quick-access management tools on the overview page.
+
+### Categories Page
+
+**Slot ID:** `0a208a9f-3b45-449c-ba8e-13a842ea5b84`
+
+- **Dashboard path:** Blog > Categories
+- **Location:** Top of page
+- **Parameters:** None
+- **Multi-plugin:** Vertical, newest at bottom
+- **Use case:** Display category analytics or bulk category management tools.
+
+### Posts Page
+
+**Slot ID:** `46035d51-2ea9-4128-a216-1dba68664ffe`
+
+- **Dashboard path:** Blog > Posts
+- **Location:** Top of page
+- **Parameters:** None
+- **Multi-plugin:** Vertical, newest at bottom
+- **Use case:** Display post analytics or quick-access post management tools.
+
+### Tags Page
+
+**Slot ID:** `0e336381-34a3-4f12-86f7-f98ab928f950`
+
+- **Dashboard path:** Blog > Tags
+- **Location:** Top of page
+- **Parameters:** None
+- **Multi-plugin:** Vertical, newest at bottom
+- **Use case:** Display tag analytics or bulk tag management tools.
+
+---
+
+## Wix Bookings
+
+### Staff Page
+
+**Slot ID:** `261e84a2-31d0-4258-a035-10544d251108`
+
+- **Dashboard path:** Settings > Booking Settings > Staff
+- **Location:** Top of page
+- **Parameters:**
+  | Name | Type | Description |
+  |------|------|-------------|
+  | `staffResourceId` | String | Staff resource ID |
+  | `scheduleId` | String | Schedule ID |
+  | `timezone` | String | Time zone |
+- **Multi-plugin:** Vertical, newest at top
+- **Use case:** Display staff availability analytics or performance metrics.
+
+### Edit Staff Profile Page
+
+**Slot ID:** `049fb0fe-cc4a-4e33-b0a9-d8cda8e7a79f`
+
+- **Dashboard path:** Settings > Booking Settings > Staff > Edit or Add staff member
+- **Location:** Top of page
+- **Parameters:**
+  | Name | Type | Description |
+  |------|------|-------------|
+  | `staffId` | String | Staff member ID |
+  | `staffResourceId` | String | Staff resource ID |
+- **Multi-plugin:** Vertical, newest at top
+- **Use case:** Extend the staff profile editing experience with custom functionality.
+
+### Services Page
+
+**Slot ID:** `78cc4a47-8f47-489b-acc2-fd9e4208c8bd`
+
+- **Dashboard path:** Booking Calendar > Services
+- **Location:** Between "Business setup recommendations" and "Service list"
+- **Parameters:** None
+- **Multi-plugin:** Horizontal, newest furthest left
+- **Use case:** Display service analytics or integrate third-party booking tools.
+
+### Calendar Page — Pre-Collect Payment Modal
+
+**Slot ID:** `b92f0e25-535f-4bef-b130-8e5abc85b2fe`
+
+- **Dashboard path:** Booking Calendar > Calendar
+- **Location:** Custom modal displayed before the default Collect Payment modal
+- **Parameters:**
+  | Name | Type | Description |
+  |------|------|-------------|
+  | `orderId` | String | Order ID |
+  | `onSuccess()` | `() => Promise<void>` | Progresses to the next modal after successful order update |
+  | `onCancel()` | `() => void` | Progresses to the next modal without changes |
+  | `menuOption` | Object | Data for the selected menu item |
+  | `menuOption.key` | String | `CHARGE_WITH_CREDIT_CARD`, `RECORD_ORDER_MANUAL_PAYMENT`, `CHARGE_WITH_INVOICE`, or `EXTENSION` |
+  | `menuOption.componentId` | String | Component ID when `EXTENSION` key is triggered |
+- **Multi-plugin:** Sequential modals, each appearing before the default modal
+- **Use case:** Add items to an order such as additional services, notes, or booking fees like insurance.
+
+> **Note:** This slot also appears on the Wix eCommerce Order Page.
+
+### Booking List Page
+
+**Slot ID:** `0f756363-1659-4929-b4ef-5ff2c458eb7d`
+
+- **Dashboard path:** Booking Calendar > Booking List
+- **Location:** Top of page
+- **Parameters:** None
+- **Multi-plugin:** Horizontal, newest furthest left
+- **Use case:** Add custom widgets or tools at the top of the booking list.
+
+---
+
+## Wix eCommerce
+
+### Order Page
+
+**Slot ID:** `cb16162e-42aa-41bd-a644-dc570328c6cc`
+
+- **Dashboard path:** Sales > Orders > Order
+- **Location:** Right side of page, under the "Order info" (customer details) card
+- **Parameters:**
+  | Name | Type | Description |
+  |------|------|-------------|
+  | `orderId` | String | Order ID |
+  | `onOrderUpdate()` | `() => Promise<void>` | Callback that notifies the host page about an order update, prompting a UI refresh |
+- **Multi-plugin:** Vertical, newest at bottom
+- **Use case:** Display a map with the delivery courier's location for the order.
+
+### Order Page — Pre-Collect Payment Modal
+
+**Slot ID:** `b92f0e25-535f-4bef-b130-8e5abc85b2fe`
+
+- **Dashboard path:** Sales > Orders > Order > Collect Payment
+- **Location:** Custom modal displayed before the default Collect Payment modal
+- **Parameters:**
+  | Name | Type | Description |
+  |------|------|-------------|
+  | `orderId` | String | Order ID |
+  | `onSuccess()` | `() => Promise<void>` | Progresses to the next modal after successful order update |
+  | `onCancel()` | `() => void` | Progresses to the next modal without changes |
+  | `menuOption` | Object | Data for the selected menu item |
+  | `menuOption.key` | String | `CHARGE_WITH_CREDIT_CARD`, `RECORD_ORDER_MANUAL_PAYMENT`, `CHARGE_WITH_INVOICE`, or `EXTENSION` |
+  | `menuOption.componentId` | String | Component ID when `EXTENSION` key is triggered |
+- **Multi-plugin:** Sequential modals, each appearing before the default modal
+- **Use case:** Add items to an order such as additional items, notes, or extra fees.
+
+> **Note:** This slot also appears on the Wix Bookings Calendar Page.
+
+### Edit Order Page — Additional Fees
+
+**Slot ID:** `057f1726-f0b3-40ef-8903-1bd104e18369`
+
+- **Dashboard path:** Sales > Orders > Order > More Actions > Edit Order
+- **Location:** Right side of page, in the "Order summary" card
+- **Parameters:**
+  | Name | Type | Description |
+  |------|------|-------------|
+  | `draftOrderId` | String | ID of the order being edited |
+  | `onDraftOrderUpdate()` | `() => Promise<void>` | Callback that notifies the host page about a draft order update, prompting a UI refresh |
+- **Multi-plugin:** Vertical, newest at bottom
+- **Use case:** Manage custom fees for orders — add or remove order fees according to custom business logic.
+
+---
+
+## Wix Events
+
+### Event Page — Overview Tab
+
+**Slot ID:** `d2c6965a-7d50-47a0-881a-beb184135df3`
+
+- **Dashboard path:** Events > Published or Drafts > Event > Overview tab
+- **Location:** Bottom of page
+- **Parameters:**
+  | Name | Type | Description |
+  |------|------|-------------|
+  | `eventId` | String | Event ID |
+- **Multi-plugin:** Vertical at bottom, newest at top
+- **Use case:** Display earnings for each ticket type so the site owner can easily compare them.
+
+### Event Page — Features Tab
+
+**Slot ID:** `5566727b-e5a2-4a43-a26d-961aa4fe0898`
+
+- **Dashboard path:** Events > Published or Drafts > Event > Features tab
+- **Location:** Features grid (displayed as cards)
+- **Parameters:**
+  | Name | Type | Description |
+  |------|------|-------------|
+  | `eventId` | String | Event ID |
+- **Multi-plugin:** Cards next to each other in the features grid, newest at top
+- **Use case:** Add an FAQ section to the event details.
+
+### Event Page — Promotion Tab
+
+**Slot ID:** `bc3b9b99-7a3a-4fb5-946f-078022277b6b`
+
+- **Dashboard path:** Events > Published or Drafts > Event > Promotion tab
+- **Location:** Bottom of page
+- **Parameters:**
+  | Name | Type | Description |
+  |------|------|-------------|
+  | `eventId` | String | Event ID |
+- **Multi-plugin:** Vertical at bottom, newest at top
+- **Use case:** Send promotional emails to customers with abandoned checkouts.
+
+### Event Page — Settings Tab
+
+**Slot ID:** `c478b36b-7ce2-4564-afba-c2b0ca14bdea`
+
+- **Dashboard path:** Events > Published or Drafts > Event > Settings tab
+- **Location:** Bottom of page
+- **Parameters:**
+  | Name | Type | Description |
+  |------|------|-------------|
+  | `eventId` | String | Event ID |
+- **Multi-plugin:** Vertical at bottom, newest at top
+- **Use case:** Set up event reminder emails to customers.
+
+### Event Page — Tickets and Seating Tab
+
+**Slot ID:** `80b95e22-26db-4063-a31f-76d4bb8797ba`
+
+- **Dashboard path:** Events > Published or Drafts > Event > Tickets and Seating tab
+- **Location:** Right side of page, below "Settings and discounts"
+- **Parameters:**
+  | Name | Type | Description |
+  |------|------|-------------|
+  | `eventId` | String | Event ID |
+- **Multi-plugin:** Vertical, newest at top
+- **Use case:** Add a ticket sales scheduler to review current ticket sale status and set up start/end dates for all ticket sales.
+
+---
+
+## Wix Stores
+
+### Products Page
+
+**Slot ID:** `3ca518a6-8ae7-45aa-8cb9-afb3da945081`
+
+- **Dashboard path:** Catalog > Store Products > Products
+- **Location:** Top of page
+- **Parameters:** None
+- **Multi-plugin:** Horizontal, newest furthest right
+- **Use case:** Add custom panels for external service integration or custom analytics tools.
+
+### Inventory Page
+
+**Slot ID:** `c9b19070-3e25-4f3d-9d27-4e0f74164835`
+
+- **Dashboard path:** Catalog > Store Products > Inventory
+- **Location:** Above inventory list
+- **Parameters:** None
+- **Multi-plugin:** Horizontal, newest furthest left
+- **Use case:** Sum the total number of available items in each product category.
+
+---
+
+## Wix Restaurants
+
+### Table Reservations Page
+
+**Slot ID:** `7f71aacd-0cbf-4b73-9ea5-482e073ea237`
+
+- **Dashboard path:** Table Reservations
+- **Location:** Top of page
+- **Parameters:**
+  | Name | Type | Description |
+  |------|------|-------------|
+  | `currentReservationLocation` | Object | Object containing information about the reservation location |
+  | `reservations` | Array | Array of objects with information about each reservation |
+  | `requests` | Array | Array of objects with information about requested reservations |
+- **Multi-plugin:** Horizontal, newest furthest right
+- **Use case:** Display statistics for the currently selected reservation location.
+
+---
+
+## Wix CRM
+
+No dashboard plugin slots available. CRM only exposes dashboard menu plugin slots.

package/skills/wix-app/references/data-collection/WIX_DATA.md

@@ -0,0 +1,270 @@
+# Wix Data SDK Reference
+
+Complete reference for working with Wix Data collections.
+
+## Installation
+
+**IMPORTANT**: The `@wix/data` package must be installed as a dependency before use.
+
+```bash
+npm install @wix/data
+```
+
+### Troubleshooting
+
+**If you encounter: `Cannot find module '@wix/data'`**
+
+❌ **WRONG**: Do not create mock implementations or workarounds
+✅ **CORRECT**: Install the package using `npm install @wix/data`
+
+The `@wix/data` package is a real npm package that provides access to Wix Data collections. 
+It must be installed before TypeScript compilation will succeed.
+
+## SDK Methods & Interfaces
+
+| Method Call | Import | TypeScript Signature | Description |
+| --- | --- | --- | --- |
+| `items.get()` | `import { items } from '@wix/data'` | `(collectionId: string, itemId: string, options?: WixDataGetOptions) => Promise<WixDataItem \| null>` | Get a single item by ID |
+| `items.query()` | `import { items } from '@wix/data'` | `(collectionId: string) => WixDataQuery` | Build a chainable query (call `.find()` to execute) |
+| `items.insert()` | `import { items } from '@wix/data'` | `(collectionId: string, item: Partial<WixDataItem>, options?: WixDataInsertOptions) => Promise<WixDataItem>` | Add a new item to a collection |
+| `items.update()` | `import { items } from '@wix/data'` | `(collectionId: string, item: WixDataItem, options?: WixDataUpdateOptions) => Promise<WixDataItem>` | Replace an existing item (item MUST include `_id`) |
+| `items.save()` | `import { items } from '@wix/data'` | `(collectionId: string, item: Partial<WixDataItem>, options?: WixDataSaveOptions) => Promise<WixDataItem>` | Insert or update (upsert) based on `_id` |
+| `items.remove()` | `import { items } from '@wix/data'` | `(collectionId: string, itemId: string, options?: WixDataRemoveOptions) => Promise<WixDataItem \| null>` | Remove an item by ID |
+| `items.bulkInsert()` | `import { items } from '@wix/data'` | `(collectionId: string, items: Partial<WixDataItem>[], options?: WixDataOptions) => Promise<WixDataBulkResult>` | Insert multiple items (max 1000) |
+| `items.bulkUpdate()` | `import { items } from '@wix/data'` | `(collectionId: string, items: WixDataItem[], options?: WixDataBulkUpdateOptions) => Promise<WixDataBulkResult>` | Update multiple items (max 1000) |
+| `items.bulkRemove()` | `import { items } from '@wix/data'` | `(collectionId: string, itemIds: string[], options?: WixDataBulkRemoveOptions) => Promise<WixDataBulkResult>` | Remove multiple items (max 1000) |
+| `items.filter()` | `import { items } from '@wix/data'` | `() => WixDataFilter` | Create a standalone filter (for use with `.or()`, `.and()`, `.not()`) |
+
+## ⚠️ Common Wrong Method Names (DO NOT USE)
+
+| ❌ WRONG (does not exist) | ✅ CORRECT |
+| --- | --- |
+| `items.queryDataItems()` | `items.query("Collection").find()` |
+| `items.insertDataItem()` | `items.insert("Collection", data)` |
+| `items.updateDataItem()` | `items.update("Collection", data)` |
+| `items.removeDataItem()` | `items.remove("Collection", id)` |
+| `items.getDataItem()` | `items.get("Collection", itemId)` |
+| `items.bulkInsertDataItems()` | `items.bulkInsert("Collection", items)` |
+
+If you see any method with `DataItem` in the name, it is **wrong**.
+
+## Full Type Definitions
+
+### WixDataItem
+
+```ts
+interface WixDataItem {
+  _id: string;
+  _createdDate?: Date;   // read-only, set by Wix on insert
+  _updatedDate?: Date;   // read-only, set by Wix on insert/update
+  _owner?: string;       // ID of the user who created the item
+  [key: string]: any;    // custom fields from your collection schema
+}
+```
+
+### WixDataResult (returned by `query().find()`)
+
+```ts
+interface WixDataResult {
+  readonly items: WixDataItem[];
+  readonly totalCount: number | undefined;  // only when returnTotalCount: true
+  readonly totalPages: number | undefined;  // only when returnTotalCount: true
+  readonly pageSize: number | undefined;
+  readonly currentPage: number | undefined;
+  readonly length: number;
+  hasNext(): boolean;
+  hasPrev(): boolean;
+  next(): Promise<WixDataResult>;
+  prev(): Promise<WixDataResult>;
+}
+```
+
+### WixDataQuery (returned by `items.query()`)
+
+Chainable query builder. Build filters, then call `.find()`, `.count()`, or `.distinct()`.
+
+```ts
+interface WixDataQuery {
+  // --- Filters ---
+  eq(field: string, value: any): WixDataQuery;
+  ne(field: string, value: any): WixDataQuery;
+  gt(field: string, value: string | number | Date): WixDataQuery;
+  ge(field: string, value: string | number | Date): WixDataQuery;
+  lt(field: string, value: string | number | Date): WixDataQuery;
+  le(field: string, value: string | number | Date): WixDataQuery;
+  between(field: string, rangeStart: string | number | Date, rangeEnd: string | number | Date): WixDataQuery;
+  contains(field: string, value: string): WixDataQuery;
+  startsWith(field: string, value: string): WixDataQuery;
+  endsWith(field: string, value: string): WixDataQuery;
+  hasSome(field: string, values: string[] | number[] | Date[]): WixDataQuery;
+  hasAll(field: string, values: string[] | number[] | Date[]): WixDataQuery;
+  isEmpty(field: string): WixDataQuery;
+  isNotEmpty(field: string): WixDataQuery;
+
+  // --- Logical operators ---
+  or(filter: WixDataFilter): WixDataQuery;
+  and(filter: WixDataFilter): WixDataQuery;
+  not(filter: WixDataFilter): WixDataQuery;
+
+  // --- Sorting ---
+  ascending(...fields: string[]): WixDataQuery;
+  descending(...fields: string[]): WixDataQuery;
+
+  // --- Pagination ---
+  limit(limitNumber: number): WixDataQuery;   // default 50, max 1000
+  skip(skipCount: number): WixDataQuery;
+
+  // --- Projection ---
+  fields(...fields: string[]): WixDataQuery;
+  include(...fields: string[]): WixDataQuery; // include referenced items
+
+  // --- Execute ---
+  find(options?: WixDataQueryOptions): Promise<WixDataResult>;
+  count(options?: WixDataReadOptions): Promise<number>;
+  distinct(field: string, options?: WixDataQueryOptions): Promise<WixDataResult<any>>;
+}
+```
+
+### Options Types
+
+```ts
+interface WixDataOptions {
+  suppressHooks?: boolean;  // skip beforeX/afterX hooks
+  showDrafts?: boolean;     // include draft items
+  appOptions?: Record<string, any>;
+}
+
+interface WixDataReadOptions extends WixDataOptions {
+  language?: string;        // IETF BCP 47 language tag
+  consistentRead?: boolean; // read from primary DB (slower but up-to-date)
+}
+
+interface WixDataQueryOptions extends WixDataReadOptions {
+  returnTotalCount?: boolean; // populate totalCount/totalPages in results
+}
+
+interface WixDataGetOptions extends WixDataReadOptions {
+  fields?: string[];                              // fields to return
+  includeReferences?: { field: string; limit?: number }[];
+  includeFieldGroups?: string[];
+}
+
+interface WixDataInsertOptions extends WixDataOptions {}
+
+interface WixDataUpdateOptions extends WixDataOptions {
+  condition?: WixDataFilter; // only update if condition is met
+}
+
+interface WixDataSaveOptions extends WixDataOptions {}
+
+interface WixDataRemoveOptions extends WixDataOptions {
+  condition?: WixDataFilter; // only remove if condition is met
+}
+
+interface WixDataBulkUpdateOptions extends WixDataOptions {
+  condition?: WixDataFilter;
+}
+
+interface WixDataBulkRemoveOptions extends WixDataOptions {
+  condition?: WixDataFilter;
+}
+```
+
+### WixDataBulkResult (returned by bulk operations)
+
+```ts
+interface WixDataBulkResult {
+  inserted: number;
+  updated: number;
+  removed: number;
+  skipped: number;
+  errors: WixDataBulkError[];
+  insertedItemIds: string[];
+  updatedItemIds: string[];
+  removedItemIds: string[];
+}
+
+interface WixDataBulkError extends Error {
+  message: string;
+  code: string;
+  originalIndex: number;      // index in the request array
+  item: WixDataItem | string; // the failed item or ID
+}
+```
+
+## Usage Examples
+
+```typescript
+import { items } from "@wix/data";
+
+// --- Get by ID ---
+const item = await items.get("MyCollection", "item-id-123");
+// Returns WixDataItem | null
+
+// --- Query with filters ---
+const result = await items.query("MyCollection")
+  .eq("status", "active")
+  .gt("price", 10)
+  .ascending("name")
+  .limit(20)
+  .find();
+// result.items: WixDataItem[]
+
+// --- Compound query with or/and ---
+const filter1 = items.filter().eq("status", "pending");
+const filter2 = items.filter().eq("status", "active");
+const result = await items.query("MyCollection")
+  .or(filter1)
+  .or(filter2)
+  .find();
+
+// --- Insert ---
+const created = await items.insert("MyCollection", {
+  title: "New Item",
+  price: 29.99,
+});
+
+// --- Update (MUST include _id) ---
+await items.update("MyCollection", {
+  _id: "item-id-123",
+  title: "Updated Title",
+  price: 39.99,
+});
+
+// ❌ WRONG — three args
+await items.update("MyCollection", "item-id", { title: "x" });
+// ✅ CORRECT — _id inside data object
+await items.update("MyCollection", { _id: "item-id", title: "x" });
+
+// --- Remove ---
+await items.remove("MyCollection", "item-id-123");
+
+// --- Bulk Insert ---
+const bulkResult = await items.bulkInsert("MyCollection", [
+  { title: "Item 1" },
+  { title: "Item 2" },
+]);
+// bulkResult.inserted: 2, bulkResult.insertedItemIds: [...]
+```
+
+## Collection Schema Rules
+
+- Always use the exact field keys defined in your collection schema
+- Use the collection ID exactly as defined in the schema
+- Use the schema's exact field types for all operations
+- Custom fields are stored in the `[key: string]: any` part of `WixDataItem`
+
+## Permissions
+
+| Operation | Required Scope |
+| --- | --- |
+| `get`, `query`, `count`, `distinct` | `SCOPE.DC-DATA.READ` |
+| `insert`, `update`, `save`, `remove`, `bulkInsert`, `bulkUpdate`, `bulkRemove` | `SCOPE.DC-DATA.WRITE` |
+
+## Date/Time Handling
+
+- **Date (date-only)**: Store as a string in "YYYY-MM-DD" format (as returned by `<input type="date" />`).
+- **DateTime (date + time)**: Store as a Date object. Accept the YYYY-MM-DDTHH:mm format returned by `<input type="datetime-local" />` and convert to a Date object using `new Date()`.
+- **Time (time-only)**: Store as a string in HH:mm or HH:mm:ss 24-hour format (as returned by `<input type="time" />`).
+- Use native JavaScript Date methods for parsing, formatting, and manipulating dates/times (e.g., `new Date()`, `toISOString()`, `toLocaleString()`, `toLocaleDateString()`).
+- Always validate incoming date/time values and provide graceful fallback or explicit error handling when values are invalid.

package/skills/wix-app/references/data-collection/extension-template.ts

@@ -0,0 +1,107 @@
+/**
+ * Template for src/extensions/data/extensions.ts
+ * 
+ * This file defines all CMS collections for your Wix CLI app.
+ * All collections are defined in a single file using extensions.genericExtension().
+ * 
+ * Replace the example collection with your actual collections.
+ */
+
+import { extensions } from '@wix/astro/builders';
+
+export const dataExtension = extensions.genericExtension({
+  // IMPORTANT: Replace with a freshly generated UUID v4 string
+  // Format: xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx
+  // Do NOT use randomUUID() - the UUID must be a static string
+  compId: '{{GENERATE_UUID}}',
+  
+  // Always 'data-extension' for CMS collections
+  compName: 'data-extension',
+  
+  // Always 'DATA_COMPONENT' for CMS collections
+  compType: 'DATA_COMPONENT',
+  
+  compData: {
+    dataComponent: {
+      // Array of all collections
+      collections: [
+        {
+          // Legacy field - will be removed in future
+          schemaUrl: 'https://www.wix.com/',
+          
+          // Collection identifier (lower-kebab-case or lower_underscore)
+          // This will be scoped with app namespace automatically
+          idSuffix: 'example-collection',
+          
+          // Human-readable name shown in CMS
+          displayName: 'Example Collection',
+          
+          // Field used for display (optional)
+          displayField: 'title',
+          
+          // Array of field definitions
+          fields: [
+            {
+              // Field identifier (lowerCamelCase, ASCII only)
+              key: 'title',
+              
+              // Human-readable label
+              displayName: 'Title',
+              
+              // Field type - see SKILL.md Field Types section for all types
+              type: 'TEXT',
+              
+              // Optional: Help text
+              description: 'The title of the item'
+            },
+            {
+              key: 'amount',
+              displayName: 'Amount',
+              type: 'NUMBER'
+            },
+            {
+              key: 'isActive',
+              displayName: 'Is Active',
+              type: 'BOOLEAN'
+            }
+            // Add more fields as needed
+          ],
+          
+          // Permission configuration
+          // See SKILL.md Permissions section for all access levels
+          dataPermissions: {
+            // Who can read items
+            itemRead: 'ANYONE',
+            
+            // Who can create items
+            itemInsert: 'PRIVILEGED',
+            
+            // Who can update items
+            itemUpdate: 'PRIVILEGED',
+            
+            // Who can delete items
+            itemRemove: 'PRIVILEGED'
+          },
+          
+          // Optional: Initial seed data
+          // Only include if blueprint mentions example data
+          initialData: [
+            {
+              // Must match field keys exactly (lowerCamelCase)
+              title: 'Example Item 1',
+              amount: 10,
+              isActive: true
+            },
+            {
+              title: 'Example Item 2',
+              amount: 20,
+              isActive: false
+            }
+            // Add more initial items as needed
+          ]
+        }
+        // Add more collections as needed
+      ]
+    }
+  }
+});