@wix/agent-skills 1.0.0

package/skills/wix-manage/references/sites/create-site-from-template.md

@@ -0,0 +1,183 @@
+---
+name: "Create Site from Template"
+description: Creates new Wix sites from templates using account-level APIs. Covers template search, site creation, headless site setup, OAuth app creation, and publishing.
+---
+# Create Site from Template
+
+This recipe guides you through creating a new Wix site from a template, including template selection and optional publishing.
+
+## Prerequisites
+
+- Wix account with site creation permissions
+- Account-level API access
+
+## Required APIs
+
+- **Templates Search API**: `GET https://www.wix.com/_api/template-cms-view-service/view/v2/templates/search`
+- **Create Site API**: `POST https://www.wixapis.com/msm/v1/meta-site/create-from-template`
+- **Publish Site API**: `POST https://www.wixapis.com/site-publisher/v1/site/publish`
+
+---
+
+## Step 1: Understand User Requirements
+
+Before searching templates, gather information:
+
+1. **Ask the user** to describe the site they want in a few sentences
+2. **Ask if they want** Wix Editor or Wix Studio
+3. **Identify main apps** needed (Stores, Bookings, Blog, etc.)
+
+### Quick Start (Skip Template Search)
+
+If user wants an empty/blank site:
+- **Wix Studio blank**: `fe86a14e-ef67-49b4-a409-d086f3abaa1a`
+- **Wix Editor blank**: `b55bdf43-95e0-4cef-b9bb-92dcc7af2742`
+
+Skip to Step 3 with these template IDs.
+
+---
+
+## Step 2: Search for Templates
+
+**Endpoint**: `GET https://www.wix.com/_api/template-cms-view-service/view/v2/templates/search`
+
+**Query Parameters**:
+| Parameter | Description | Values |
+|-----------|-------------|--------|
+| `language` | Always use | `en` |
+| `limit` | Results per page | `24` |
+| `offset` | Pagination offset | Start at `0`, increment by 24 |
+| `bookType` | Editor type | `studio` or `main-v2` |
+| `query` | Search keywords | `yoga+studio`, `ecommerce`, etc. |
+
+**Example Request**:
+```bash
+curl -X GET \
+  'https://www.wix.com/_api/template-cms-view-service/view/v2/templates/search?language=en&limit=24&offset=0&bookType=studio&query=yoga+studio' \
+  -H 'Authorization: <AUTH>'
+```
+
+**Response** includes for each template:
+- `metaSiteId` - Template ID for creation
+- `templateSlug` - For preview URL
+- Template name and description
+- Color scheme
+
+### Present Templates to User
+
+For each relevant template, show:
+- Template name
+- Description (without "Click Edit" text)
+- "Good for" description
+- Color scheme
+- Preview link: `https://www.wix.com/website-template/view/html/{templateSlug}`
+
+---
+
+## Step 3: Create the Site
+
+**Endpoint**: `POST https://www.wixapis.com/msm/v1/meta-site/create-from-template`
+
+**Request Body**:
+```json
+{
+  "originTemplateId": "<TEMPLATE_METASITE_ID>",
+  "siteName": "my-new-site"
+}
+```
+
+**Request**:
+```bash
+curl -X POST \
+  'https://www.wixapis.com/msm/v1/meta-site/create-from-template' \
+  -H 'Authorization: <AUTH>' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "originTemplateId": "<TEMPLATE_ID>",
+    "siteName": "my-new-site"
+  }'
+```
+
+### Site Name Requirements
+
+The `siteName` must follow these rules:
+- 4-20 characters
+- Only lowercase letters, numbers, hyphens, underscores
+- Pattern: `[a-z0-9_-]{4,20}`
+- Must be unique
+
+If `siteName` is not provided, one is generated automatically.
+
+### For Headless Sites
+
+Add `"namespace": "HEADLESS"` to the request body:
+
+```json
+{
+  "originTemplateId": "<TEMPLATE_ID>",
+  "siteName": "my-headless-site",
+  "namespace": "HEADLESS"
+}
+```
+
+**Response** includes the new site's `metaSiteId`.
+
+### IMPORTANT NOTES:
+- Only mention headless if user specifically requests it
+- If user doesn't ask for headless, do NOT include the `namespace` field
+
+---
+
+## Step 4: Publish the Site (Optional)
+
+**Ask the user** if they want to publish their site before proceeding.
+
+**Endpoint**: `POST https://www.wixapis.com/site-publisher/v1/site/publish`
+
+This is a **site-level API** - use the site ID from the creation response.
+
+**Request**:
+```bash
+curl -X POST \
+  'https://www.wixapis.com/site-publisher/v1/site/publish' \
+  -H 'Authorization: <AUTH>' \
+  -H 'Content-Type: application/json' \
+  -d '{}'
+```
+
+### IMPORTANT NOTES:
+- NEVER publish without asking the user first
+- This makes the site publicly accessible
+
+---
+
+## Step 5: For Headless Sites - Create OAuth App
+
+If the site was created as headless, you MUST create an OAuth app for authentication.
+
+See [Create OAuth App](https://dev.wix.com/docs/api-reference/business-management/headless/oauth-apps/create-oauth-app) documentation.
+
+This is a site-level call in the context of the newly created site.
+
+---
+
+## Common Template IDs
+
+For quick access without searching:
+
+| Type | Template ID |
+|------|-------------|
+| Blank (Studio) | `fe86a14e-ef67-49b4-a409-d086f3abaa1a` |
+| Blank (Editor) | `b55bdf43-95e0-4cef-b9bb-92dcc7af2742` |
+| Store | `b783f9f9-4f4d-4139-9659-cc95a51b9ee5` |
+| Bookings/Services | `17b2bf9e-8661-4c92-973c-67502b415e58` |
+| Beauty | `0281d415-0682-42ac-b35e-49b349f19332` |
+
+---
+
+## Next Steps
+
+After creating the site:
+- Install required apps using [Install Wix Apps](../app-installation/install-wix-apps.md)
+- Configure site settings
+- Add content (products, services, blog posts, etc.)

package/skills/wix-manage/references/sites/query-sites.md

@@ -0,0 +1,125 @@
+---
+name: "Query Sites"
+description: Lists and queries all sites associated with a Wix account using Sites API. Covers pagination with cursor-based navigation.
+---
+# Query Sites
+
+This recipe demonstrates how to list and query all sites associated with a Wix account.
+
+## Prerequisites
+
+- Account-level API access
+- Authorization for site listing permissions
+
+## Required APIs
+
+- **Query Sites API**: [REST](https://dev.wix.com/docs/api-reference/account-level/sites/sites/query-sites)
+
+---
+
+## Query All Sites
+
+**Endpoint**: `POST https://www.wixapis.com/site-list/v2/sites/query`
+
+**Request Body**:
+```json
+{
+  "query": {
+    "cursorPaging": {
+      "limit": 50
+    }
+  }
+}
+```
+
+**Request**:
+```bash
+curl -X POST \
+  'https://www.wixapis.com/site-list/v2/sites/query' \
+  -H 'Authorization: <AUTH>' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "query": {
+      "cursorPaging": {
+        "limit": 50
+      }
+    }
+  }'
+```
+
+---
+
+## Response Structure
+
+```json
+{
+  "sites": [
+    {
+      "id": "site-id-123",
+      "name": "My Website",
+      "displayName": "My Website",
+      "siteUrl": "https://username.wixsite.com/mywebsite",
+      "published": true,
+      "createdDate": "2024-01-15T10:30:00Z",
+      "updatedDate": "2024-06-20T14:45:00Z"
+    }
+  ],
+  "pagingMetadata": {
+    "count": 50,
+    "cursors": {
+      "next": "cursor-for-next-page"
+    },
+    "hasNext": true
+  }
+}
+```
+
+---
+
+## Pagination
+
+For accounts with many sites, use cursor-based pagination:
+
+**First Request**:
+```json
+{
+  "query": {
+    "cursorPaging": {
+      "limit": 50
+    }
+  }
+}
+```
+
+**Next Page** (using cursor from response):
+```json
+{
+  "query": {
+    "cursorPaging": {
+      "limit": 50,
+      "cursor": "<cursor-from-previous-response>"
+    }
+  }
+}
+```
+
+Continue until `hasNext` is `false`.
+
+---
+
+## Common Use Cases
+
+### List All Sites
+Retrieve all sites without filtering - useful for account dashboards or site selection interfaces.
+
+### Find a Specific Site
+After querying, filter results by name or ID to locate a specific site.
+
+---
+
+## Next Steps
+
+After finding a site:
+- Use the site ID for site-level API calls
+- Create new sites using [Create Site from Template](create-site-from-template.md)
+- Manage site settings and content

package/skills/wix-manage/references/stores/add-store-pages-to-site.md

@@ -0,0 +1,57 @@
+---
+name: "Add Store Pages to Site"
+description: Adds missing checkout and cart pages to a site when Stores app is installed. Used when store pages are missing after migration or setup issues.
+---
+# Add Store Pages to Site
+
+This recipe demonstrates how to add checkout and cart pages to a Wix site when the Stores app is installed but pages are missing.
+
+## Overview
+
+When Wix Stores is installed on a site, it should automatically create cart and checkout pages. However, in some cases these pages may be missing. This recipe provides a way to add them programmatically.
+
+## Prerequisites
+
+- Wix Stores app installed on the site
+- API access with site management permissions
+
+---
+
+## Step 1: Add Pages to Site
+
+**Endpoint**: `POST https://www.wix.com/_api/add-pages-to-site/install`
+
+**Request**:
+```bash
+curl -X POST \
+  'https://www.wix.com/_api/add-pages-to-site/install' \
+  -H 'Authorization: <AUTH>' \
+  -H 'Content-Type: application/json' \
+  -d '{}'
+```
+
+**Response**: Empty body on success.
+
+### IMPORTANT NOTES:
+- This endpoint adds missing store pages (cart, checkout) if they don't exist
+- The request body is empty - no parameters needed
+- Only required Authorization header
+
+---
+
+## When to Use This Recipe
+
+Use this recipe when:
+- Checkout flow fails because checkout page is missing
+- Cart functionality doesn't work
+- Store was migrated or had page issues
+- You receive errors about missing store pages
+
+---
+
+## Next Steps
+
+After adding pages:
+- Verify checkout flow works by creating a test order
+- Customize page designs if needed via the Editor
+- Set up payment methods if not already configured