@clawpify/skills 1.0.1

package/clawpify/references/pages.md

@@ -0,0 +1,308 @@
+# Shopify Pages
+
+Manage online store pages (About Us, Contact, policies, etc.) via the GraphQL Admin API.
+
+## Overview
+
+Pages are custom content pages displayed on the storefront, separate from products and collections.
+
+## List Pages
+
+```graphql
+query ListPages($first: Int!, $after: String, $query: String) {
+  pages(first: $first, after: $after, query: $query, sortKey: TITLE) {
+    pageInfo {
+      hasNextPage
+      endCursor
+    }
+    nodes {
+      id
+      title
+      handle
+      isPublished
+      createdAt
+      updatedAt
+    }
+  }
+}
+```
+Variables: `{ "first": 10 }`
+
+## Get Page
+
+```graphql
+query GetPage($id: ID!) {
+  page(id: $id) {
+    id
+    title
+    handle
+    body
+    isPublished
+    publishedAt
+    createdAt
+    updatedAt
+    templateSuffix
+    metafields(first: 10) {
+      nodes {
+        key
+        namespace
+        value
+        type
+      }
+    }
+  }
+}
+```
+Variables: `{ "id": "gid://shopify/Page/123" }`
+
+## Get Pages Count
+
+```graphql
+query GetPagesCount {
+  pagesCount {
+    count
+  }
+}
+```
+
+## Create Page
+
+```graphql
+mutation CreatePage($page: PageCreateInput!) {
+  pageCreate(page: $page) {
+    page {
+      id
+      title
+      handle
+      isPublished
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "page": {
+    "title": "About Us",
+    "handle": "about-us",
+    "body": "<h1>About Our Company</h1><p>We are passionate about delivering quality products...</p>",
+    "isPublished": true
+  }
+}
+```
+
+## Create Page with Metafields
+
+```graphql
+mutation CreatePageWithMetafields($page: PageCreateInput!) {
+  pageCreate(page: $page) {
+    page {
+      id
+      title
+      metafields(first: 5) {
+        nodes {
+          key
+          value
+        }
+      }
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "page": {
+    "title": "Store Locations",
+    "body": "<p>Find a store near you.</p>",
+    "isPublished": true,
+    "metafields": [
+      {
+        "namespace": "custom",
+        "key": "show_map",
+        "value": "true",
+        "type": "boolean"
+      }
+    ]
+  }
+}
+```
+
+## Update Page
+
+```graphql
+mutation UpdatePage($id: ID!, $page: PageUpdateInput!) {
+  pageUpdate(id: $id, page: $page) {
+    page {
+      id
+      title
+      body
+      isPublished
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "id": "gid://shopify/Page/123",
+  "page": {
+    "body": "<h1>About Our Company</h1><p>Updated content with new information...</p>"
+  }
+}
+```
+
+## Publish/Unpublish Page
+
+```graphql
+mutation PublishPage($id: ID!, $page: PageUpdateInput!) {
+  pageUpdate(id: $id, page: $page) {
+    page {
+      id
+      isPublished
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "id": "gid://shopify/Page/123",
+  "page": {
+    "isPublished": true
+  }
+}
+```
+
+## Delete Page
+
+```graphql
+mutation DeletePage($id: ID!) {
+  pageDelete(id: $id) {
+    deletedPageId
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+
+## Search Pages
+
+```graphql
+query SearchPages($query: String!) {
+  pages(first: 10, query: $query) {
+    nodes {
+      id
+      title
+      handle
+      isPublished
+    }
+  }
+}
+```
+Variables: `{ "query": "title:contact OR title:about" }`
+
+## Page Fields
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `title` | String | Page title |
+| `handle` | String | URL handle (e.g., `/pages/about-us`) |
+| `body` | HTML | Page content (HTML) |
+| `isPublished` | Boolean | Visibility status |
+| `publishedAt` | DateTime | Publication timestamp |
+| `templateSuffix` | String | Custom template suffix |
+
+## Template Suffixes
+
+Use template suffixes to apply custom page templates:
+
+```json
+{
+  "page": {
+    "title": "Contact Us",
+    "body": "<p>Get in touch...</p>",
+    "templateSuffix": "contact"
+  }
+}
+```
+
+This uses `page.contact.liquid` template in the theme.
+
+## Search Query Filters
+
+| Filter | Example | Description |
+|--------|---------|-------------|
+| `title` | `title:about` | Filter by title |
+| `created_at` | `created_at:>2024-01-01` | Filter by creation date |
+| `updated_at` | `updated_at:>2024-01-01` | Filter by update date |
+| `published_status` | `published_status:published` | Filter by publish status |
+
+## API Scopes Required
+
+- `read_content` - Read pages
+- `write_content` - Create, update, delete pages
+
+## Common Use Cases
+
+### Policy Pages
+```json
+{
+  "page": {
+    "title": "Privacy Policy",
+    "handle": "privacy-policy",
+    "body": "<h1>Privacy Policy</h1><p>Your privacy is important to us...</p>",
+    "isPublished": true
+  }
+}
+```
+
+### FAQ Page
+```json
+{
+  "page": {
+    "title": "Frequently Asked Questions",
+    "handle": "faq",
+    "body": "<h1>FAQ</h1><details><summary>How do I track my order?</summary><p>You can track your order...</p></details>",
+    "isPublished": true
+  }
+}
+```
+
+### Contact Page with Custom Template
+```json
+{
+  "page": {
+    "title": "Contact Us",
+    "handle": "contact",
+    "body": "",
+    "isPublished": true,
+    "templateSuffix": "contact"
+  }
+}
+```
+
+## Notes
+
+- Handles must be unique and URL-safe
+- HTML in body is sanitized by Shopify
+- Pages are separate from product and collection pages
+- Use metafields to store additional structured data

package/clawpify/references/products.md

@@ -0,0 +1,277 @@
+# Shopify Products & Variants
+
+## Products
+
+### List Products
+
+```graphql
+query ListProducts($first: Int!, $after: String) {
+  products(first: $first, after: $after) {
+    pageInfo {
+      hasNextPage
+      endCursor
+    }
+    nodes {
+      id
+      title
+      status
+      vendor
+      productType
+      createdAt
+      updatedAt
+    }
+  }
+}
+```
+Variables: `{ "first": 10 }`
+
+### Get Product by ID
+
+```graphql
+query GetProduct($id: ID!) {
+  product(id: $id) {
+    id
+    title
+    descriptionHtml
+    status
+    vendor
+    productType
+    tags
+    options {
+      name
+      values
+    }
+    variants(first: 100) {
+      nodes {
+        id
+        title
+        sku
+        price
+        inventoryQuantity
+        selectedOptions {
+          name
+          value
+        }
+      }
+    }
+    images(first: 10) {
+      nodes {
+        id
+        url
+        altText
+      }
+    }
+  }
+}
+```
+Variables: `{ "id": "gid://shopify/Product/123" }`
+
+### Search Products
+
+```graphql
+query SearchProducts($query: String!, $first: Int!) {
+  products(first: $first, query: $query) {
+    nodes {
+      id
+      title
+      status
+      vendor
+    }
+  }
+}
+```
+Variables: `{ "query": "title:*shirt*", "first": 10 }`
+
+Search query syntax:
+- `title:*keyword*` - title contains keyword
+- `status:ACTIVE` - by status (ACTIVE, DRAFT, ARCHIVED)
+- `vendor:Nike` - by vendor
+- `product_type:Shoes` - by product type
+- Combine with `AND`, `OR`: `status:ACTIVE AND vendor:Nike`
+
+### Create Product
+
+```graphql
+mutation CreateProduct($product: ProductCreateInput!, $media: [CreateMediaInput!]) {
+  productCreate(product: $product, media: $media) {
+    product {
+      id
+      title
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "product": {
+    "title": "New Product",
+    "descriptionHtml": "<p>Product description</p>",
+    "vendor": "My Store",
+    "productType": "Clothing",
+    "status": "DRAFT",
+    "tags": ["new", "featured"]
+  }
+}
+```
+
+### Update Product
+
+> REQUIRES PERMISSION: If changing product status from DRAFT to ACTIVE, this publishes the product and makes it visible to customers. Always ask the user for explicit confirmation before changing status to ACTIVE.
+
+```graphql
+mutation UpdateProduct($product: ProductUpdateInput!) {
+  productUpdate(product: $product) {
+    product {
+      id
+      title
+      status
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "product": {
+    "id": "gid://shopify/Product/123",
+    "title": "Updated Title",
+    "status": "ACTIVE"
+  }
+}
+```
+
+### Delete Product
+
+> REQUIRES PERMISSION: Deleting a product is PERMANENT and removes it from your store completely. All variants, images, and data will be lost and cannot be recovered. Always ask the user for explicit confirmation, show the product title and ID, and wait for approval before executing this operation.
+
+```graphql
+mutation DeleteProduct($input: ProductDeleteInput!) {
+  productDelete(input: $input) {
+    deletedProductId
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables: `{ "input": { "id": "gid://shopify/Product/123" } }`
+
+---
+
+## Product Variants
+
+### Create Variants (Bulk)
+
+```graphql
+mutation CreateVariants($productId: ID!, $variants: [ProductVariantsBulkInput!]!) {
+  productVariantsBulkCreate(productId: $productId, variants: $variants) {
+    productVariants {
+      id
+      title
+      sku
+      price
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "productId": "gid://shopify/Product/123",
+  "variants": [
+    {
+      "barcode": "1234567890",
+      "price": "29.99",
+      "optionValues": [
+        { "optionName": "Size", "name": "Small" },
+        { "optionName": "Color", "name": "Blue" }
+      ],
+      "inventoryItem": {
+        "sku": "SKU-001"
+      }
+    }
+  ]
+}
+```
+
+### Update Variants (Bulk)
+
+```graphql
+mutation UpdateVariants($productId: ID!, $variants: [ProductVariantsBulkInput!]!) {
+  productVariantsBulkUpdate(productId: $productId, variants: $variants) {
+    productVariants {
+      id
+      price
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "productId": "gid://shopify/Product/123",
+  "variants": [
+    {
+      "id": "gid://shopify/ProductVariant/456",
+      "price": "34.99"
+    }
+  ]
+}
+```
+
+### Delete Variants (Bulk)
+
+> REQUIRES PERMISSION: Bulk deleting product variants is PERMANENT and cannot be undone. All variant data will be lost. Always ask the user for explicit confirmation, list the variants to be deleted, and wait for approval before executing this operation.
+
+```graphql
+mutation DeleteVariants($productId: ID!, $variantsIds: [ID!]!) {
+  productVariantsBulkDelete(productId: $productId, variantsIds: $variantsIds) {
+    product {
+      id
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}
+```
+Variables:
+```json
+{
+  "productId": "gid://shopify/Product/123",
+  "variantsIds": ["gid://shopify/ProductVariant/456"]
+}
+```
+
+## Dangerous Operations in This Skill
+
+The following operations require explicit user permission before execution:
+
+| Operation | Impact | Reversible |
+|-----------|--------|------------|
+| `productUpdate` (status: ACTIVE) | Publishes product and makes it visible to customers | Yes (can set back to DRAFT) |
+| `productDelete` | Permanently deletes product and all variants | No - IRREVERSIBLE |
+| `productVariantsBulkDelete` | Permanently deletes multiple variants at once | No - IRREVERSIBLE |
+
+Permission Protocol: 
+- For status changes to ACTIVE: Show product title and confirm publication
+- For deletions: Show product/variant details, emphasize permanence, wait for explicit "yes", "confirm", or "proceed"