@wix/agent-skills 1.12.0 → 1.13.0

package/skills/wix-manage/references/ecommerce/guardrail-rate-pricing-sanity.md

@@ -1,108 +0,0 @@
----
-name: "Guardrail: Rate Pricing Sanity"
-description: Validates shipping rate pricing against AOV and catalog data. Flags excessive rates, per-item penalties, unreachable free shipping thresholds, and backup rate sticker shock.
-layer: guardrail
----
-# Guardrail: Rate Pricing Sanity
-
-## When to use
-
-Run these checks when evaluating existing shipping rates or before creating/updating shipping rate configurations. All thresholds are relative to the store's Average Order Value (AOV).
-
----
-
-## Check 1: Excessive shipping cost
-
-**Threshold**: Any rate `amount` > AOV x 0.15 (15%)
-
-**Why**: Shipping costs above 15% of order value are a top reason for cart abandonment. Customers who see disproportionately high shipping fees frequently abandon their carts.
-
-**Detection**:
-- For each shipping rate, compare `amount` against `AOV × 0.15`
-- If exceeded → flag:
-
-> "Shipping rate '{title}' charges ${amount}, which is {pct}% of your average order value (${AOV}). Shipping costs above 15% of order value are a top reason for cart abandonment."
-
----
-
-## Check 2: Per-item penalty (multiplyByQuantity)
-
-**Trigger**: `multiplyByQuantity: true` on any shipping rate
-
-**Why**: Per-item shipping charges penalize larger orders and discourage customers from adding more items to cart.
-
-**Detection**:
-- Find all rates with `multiplyByQuantity: true`
-- Calculate the impact for a typical multi-item order:
-
-> "Your '{title}' rate charges per item (${amount} x quantity). A 5-item order costs ${amount x 5}. Switch to a flat rate or tiered pricing to encourage larger orders."
-
----
-
-## Check 3: Free shipping threshold too high
-
-**Threshold**: Free shipping threshold > AOV x 2
-
-**Why**: If the free shipping minimum is more than double the average order, very few customers will ever qualify. The threshold should be achievable — close enough to the AOV to encourage customers to add one more item.
-
-**Detection**:
-- Compare free shipping `threshold` against `AOV × 2`
-- If exceeded → flag:
-
-> "Your free shipping threshold (${threshold}) is {X}x your average order (${AOV}). Most customers won't reach it. Lower to ${AOV x 1.2} to make it achievable and drive larger orders."
-
----
-
-## Check 4: Free shipping threshold too low
-
-**Threshold**: Free shipping threshold < AOV x 0.8
-
-**Why**: If the threshold is below the average order value, most customers already qualify for free shipping without adding anything to their cart. This provides no upsell incentive and may erode margins unnecessarily.
-
-**Detection**:
-- Compare free shipping `threshold` against `AOV × 0.8`
-- If below → flag:
-
-> "Your free shipping threshold (${threshold}) is below your average order value (${AOV}). Most customers already qualify, so this threshold isn't driving larger orders. Consider raising it to ${AOV x 1.2} to encourage add-on purchases."
-
----
-
-## Check 5: Backup rate sticker shock
-
-**Threshold**: `backupRate.amount` > effective AOV x 0.15
-
-**Why**: Backup rates apply when the primary carrier can't fulfill (e.g., remote address, service outage). If the backup rate is dramatically higher than normal shipping, customers experience sticker shock at checkout.
-
-**Detection**:
-- For each carrier's `backupRate`, compare `amount` against `effective_aov × 0.15`
-- If exceeded → flag:
-
-> "Backup rate of ${amount} is {pct}% of your average order value. When triggered, this will surprise customers with unexpectedly high shipping. Set the backup rate to 5-10% of average order value (${effective_aov x 0.05} - ${effective_aov x 0.10})."
-
----
-
-## Check 6: Hidden surcharges
-
-**Threshold**: Total `additionalCharges` across all carriers > AOV x 0.10
-
-**Why**: Carrier surcharges (fuel, residential delivery, handling fees) add up. If the total surcharge burden exceeds 10% of the order value, it may negate the perceived value of the base shipping rate.
-
-**Detection**:
-- Sum all `additionalCharges` across active carriers
-- Compare total against `AOV × 0.10`
-- If exceeded → flag:
-
-> "Carrier surcharges add ${total} to shipping costs. Combined with base rates, total shipping cost may deter customers. Review each surcharge to determine if it's necessary."
-
----
-
-## Summary: Pricing sanity thresholds
-
-| Check | Threshold | Action |
-|---|---|---|
-| Excessive rate | Rate > 15% of AOV | Flag — cart abandonment risk |
-| Per-item penalty | `multiplyByQuantity: true` | Flag — discourages larger orders |
-| Free threshold too high | Threshold > 2x AOV | Flag — unreachable for most customers |
-| Free threshold too low | Threshold < 0.8x AOV | Flag — no upsell incentive, margin erosion |
-| Backup rate shock | Backup > 15% of AOV | Flag — recommend 5-10% of AOV |
-| Hidden surcharges | Total surcharges > 10% of AOV | Flag — review necessity |

package/skills/wix-manage/references/ecommerce/guardrail-shipping-health.md

@@ -1,124 +0,0 @@
----
-name: "Guardrail: Shipping Health"
-description: Shipping health score calculation (CRITICAL/POOR/FAIR/GOOD/EXCELLENT) with exact scoring criteria. Includes the mandatory business context filter for international shipping recommendations.
-layer: guardrail
-references:
-  - name: "Troubleshoot: Checkout Delivery Drop-off"
-    path: ecommerce/troubleshoot-checkout-delivery-dropoff.md
-    load: false
----
-# Guardrail: Shipping Health
-
-> **Related skills**:
-> - [Troubleshoot: Checkout Delivery Drop-off](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/troubleshoot-checkout-delivery-dropoff)
-
-## When to use
-
-Calculate the shipping health score whenever evaluating a store's shipping configuration. Use this score to prioritize recommendations and determine urgency of shipping issues.
-
----
-
-## Health score levels
-
-### CRITICAL
-
-Any of the following conditions:
-
-- `delivery_profiles` is empty AND `shipping_options` is empty
-- All regions across all profiles have `active: false`
-
-**Implication**: The store cannot ship any orders. Immediate action required.
-
-### POOR
-
-Any of the following conditions:
-
-- Only 1 delivery profile with empty regions
-- Only 1 shipping option total
-- `delivery_step_cvr` < 50% with shipping issues detected
-- All carriers have `backupRate.active: false`
-
-**Implication**: Shipping is minimally functional but has significant gaps that are likely causing lost sales.
-
-### FAIR
-
-All of the following conditions:
-
-- 1-2 delivery profiles with 1-2 active regions
-- 2-4 shipping options
-- No free shipping option available
-- OR: `delivery_step_cvr` between 50-65%
-
-**Implication**: Basic shipping is working but missing key elements that drive conversion.
-
-### GOOD
-
-All of the following conditions:
-
-- 1+ delivery profiles with both domestic and international regions
-- 3-5 shipping options including at least one free shipping option
-- 1+ active carriers
-- `delivery_step_cvr` between 65-75%
-
-**Implication**: Solid shipping setup. Optimization opportunities exist but fundamentals are covered.
-
-### EXCELLENT
-
-All of the following conditions:
-
-- Multiple active regions
-- Tiered shipping rates
-- Free shipping option available
-- Multiple carriers with backup rates enabled
-- Pickup and/or local delivery options configured
-- `delivery_step_cvr` ≥ 75%
-- No `multiplyByQuantity` pricing on any rate
-
-**Implication**: Best-in-class shipping configuration. Focus on maintaining and fine-tuning.
-
----
-
-## Business context filter (MANDATORY)
-
-**This filter MUST be applied before recommending any international shipping action.**
-
-### Check business type
-
-Inspect the store's `industry` and `businessType` fields (case-insensitive match) for any of the following keywords:
-
-- food
-- restaurant
-- grocery
-- bakery
-- catering
-- perishable
-- fresh
-- meat
-- produce
-- dairy
-- drink
-- beverage
-
-### If matched
-
-**DO NOT recommend any international shipping action.** Perishable/food businesses face regulatory, spoilage, and logistics barriers that make international shipping impractical as a default recommendation.
-
-### Identifying international regions
-
-A region is considered "international" if any of the following are true:
-
-- Region `name` contains "international" or "internacional" (case-insensitive)
-- Region `destinations[]` is empty (wildcard / all countries)
-- Region `destinations` include countries outside the store's home country
-
----
-
-## Summary: Score decision table
-
-| Score | Key indicator | Action |
-|---|---|---|
-| CRITICAL | No profiles/options or all regions inactive | Immediate setup required |
-| POOR | Minimal config, low CVR, or no backup rates | Address fundamental gaps |
-| FAIR | Basic setup, no free shipping, moderate CVR | Add free shipping, expand regions |
-| GOOD | Domestic + international, free shipping, good CVR | Optimize rates and carriers |
-| EXCELLENT | Full coverage, tiered rates, high CVR | Maintain and fine-tune |

package/skills/wix-manage/references/ecommerce/recipe-apply-shipping-recommendations.md

@@ -1,298 +0,0 @@
----
-name: "Recipe: Apply Shipping Recommendations"
-description: Applies AI-generated shipping recommendations to a Wix e-commerce store. Reads the current delivery profile and shipping options, then creates or updates shipping options based on recommendation data. Supports creating new options with conditional rates, updating existing options, and querying delivery profiles for region/carrier context.
----
-# Apply Shipping Recommendations
-
-## Prerequisites
-
-- Wix Stores (or another eCommerce business solution) installed on the site
-- Shipping recommendations data available (from the AI recommendation system or provided directly)
-
-## Required APIs
-
-- [Query Delivery Profiles](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping#query-delivery-profiles)
-- [Get Delivery Profile](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping#get-delivery-profile)
-
----
-
-## Step 1: Query the current shipping configuration
-
-Call [Query Delivery Profiles](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping#query-delivery-profiles) to understand the site's delivery setup — profiles, regions, carriers, and backup rates.
-
-**Endpoint**: `POST https://www.wixapis.com/ecom/v1/delivery-profiles/query`
-
-**Request**:
-```json
-{
-  "query": {
-    "cursorPaging": {
-      "limit": 100
-    }
-  }
-}
-```
-
-**Response**:
-```json
-{
-  "deliveryProfiles": [
-    {
-      "id": "6a9b2f9b-533a-4d0d-ac8d-64ec3f32fcbd",
-      "name": "General profile",
-      "default": true,
-      "deliveryRegions": [
-        {
-          "id": "42b0ed3b-fc54-4ac0-89cf-5d2d17ec441c",
-          "name": "Domestic",
-          "active": true,
-          "deliveryCarriers": [
-            {
-              "appId": "45c44b27-ca7b-4891-8c0d-1747d588b835",
-              "additionalCharges": []
-            }
-          ],
-          "destinations": [
-            {
-              "countryCode": "GB",
-              "subdivisions": []
-            }
-          ]
-        }
-      ],
-      "revision": "43",
-      "createdDate": "2025-10-26T11:05:10.774Z",
-      "updatedDate": "2026-04-14T14:43:25.397Z"
-    }
-  ],
-  "pagingMetadata": {
-    "count": 1,
-    "cursors": {},
-    "hasNext": false
-  }
-}
-```
-
-Save the profile `id`, `revision`, and each region's `id` and `active` status. Identify which regions have carriers with missing backup rates (`backupRate` absent or `backupRate.active: false`).
-
----
-
-## Step 2: Query existing shipping options
-
-**Endpoint**: `POST https://www.wixapis.com/ecom/v1/shipping-options/query`
-
-**Request**:
-```json
-{
-  "query": {
-    "cursorPaging": {
-      "limit": 100
-    }
-  }
-}
-```
-
-**Response**:
-```json
-{
-  "shippingOptions": [
-    {
-      "id": "c0e5be8f-5266-4720-a732-5f571e4750db",
-      "revision": "1",
-      "createdDate": "2026-04-14T14:43:24.804Z",
-      "updatedDate": "2026-04-14T14:43:24.804Z",
-      "deliveryRegionId": "42b0ed3b-fc54-4ac0-89cf-5d2d17ec441c",
-      "deliveryRegionIds": [],
-      "title": "Standard Shipping",
-      "estimatedDeliveryTime": "5-7 business days",
-      "rates": [
-        {
-          "amount": "15.00",
-          "conditions": [],
-          "multiplyByQuantity": false
-        }
-      ]
-    }
-  ],
-  "pagingMetadata": {
-    "count": 1,
-    "cursors": {},
-    "hasNext": false
-  }
-}
-```
-
-Note: The response uses `deliveryRegionId` (singular) as the primary field linking an option to a region.
-
----
-
-## Step 3: Apply recommendation — Create a new shipping option
-
-When the recommendation action is `create_shipping_option`, create a new option linked to a specific delivery region.
-
-**Endpoint**: `POST https://www.wixapis.com/ecom/v1/shipping-options`
-
-**Request** — flat rate example:
-```json
-{
-  "shippingOption": {
-    "title": "Express Shipping",
-    "estimatedDeliveryTime": "1-2 business days",
-    "deliveryRegionId": "42b0ed3b-fc54-4ac0-89cf-5d2d17ec441c",
-    "rates": [
-      {
-        "amount": "12.99",
-        "multiplyByQuantity": false,
-        "conditions": []
-      }
-    ]
-  }
-}
-```
-
-**Response**:
-```json
-{
-  "shippingOption": {
-    "id": "dece6160-4e72-4fcc-adcc-7607215edab0",
-    "revision": "1",
-    "createdDate": "2026-04-15T13:14:01.214Z",
-    "updatedDate": "2026-04-15T13:14:01.214Z",
-    "deliveryRegionId": "42b0ed3b-fc54-4ac0-89cf-5d2d17ec441c",
-    "deliveryRegionIds": [],
-    "title": "Express Shipping",
-    "estimatedDeliveryTime": "1-2 business days",
-    "rates": [
-      {
-        "amount": "12.99",
-        "conditions": [],
-        "multiplyByQuantity": false
-      }
-    ]
-  }
-}
-```
-
-**Request** — free shipping with price threshold:
-```json
-{
-  "shippingOption": {
-    "title": "Free Shipping",
-    "estimatedDeliveryTime": "5-7 business days",
-    "deliveryRegionId": "42b0ed3b-fc54-4ac0-89cf-5d2d17ec441c",
-    "rates": [
-      {
-        "amount": "0",
-        "multiplyByQuantity": false,
-        "conditions": [
-          {
-            "type": "BY_TOTAL_PRICE",
-            "operator": "GTE",
-            "value": "75"
-          }
-        ]
-      }
-    ]
-  }
-}
-```
-
-**Key field rules:**
-
-| Field | Required | Notes |
-|---|---|---|
-| `title` | Yes | Display name at checkout |
-| `estimatedDeliveryTime` | Yes | Free text shown to customers |
-| `deliveryRegionId` | Yes | Region UUID from Step 1. Must use **singular** field, not `deliveryRegionIds` |
-| `rates` | Yes | Array of rate objects |
-| `rates[].amount` | Yes | Decimal string (`"5.99"`, `"0"` for free) |
-| `rates[].multiplyByQuantity` | Yes | Almost always `false` |
-| `rates[].conditions` | Yes | Empty array for flat rate; see condition types below |
-
-**Condition types** (for tiered/conditional rates):
-
-| Type | Description | Example |
-|---|---|---|
-| `BY_TOTAL_PRICE` | Cart total threshold | `"operator": "GTE", "value": "75"` |
-| `BY_TOTAL_WEIGHT` | Weight threshold | `"operator": "LTE", "value": "10"` |
-| `BY_TOTAL_QUANTITY` | Item count threshold | `"operator": "GTE", "value": "3"` |
-
-Operators: `EQ`, `GT`, `GTE`, `LT`, `LTE`
-
----
-
-## Step 4: Apply recommendation — Update an existing shipping option
-
-When the recommendation action is `update_shipping_option`, update an existing option's title, delivery time, or rates.
-
-**Endpoint**: `PATCH https://www.wixapis.com/ecom/v1/shipping-options/{shippingOptionId}`
-
-Replace `{shippingOptionId}` with the option's `id` from Step 2.
-
-**Request**:
-```json
-{
-  "shippingOption": {
-    "id": "c0e5be8f-5266-4720-a732-5f571e4750db",
-    "revision": "1",
-    "title": "Updated Standard Shipping",
-    "estimatedDeliveryTime": "3-5 business days",
-    "rates": [
-      {
-        "amount": "9.99",
-        "multiplyByQuantity": false,
-        "conditions": []
-      }
-    ]
-  }
-}
-```
-
-**Response**:
-```json
-{
-  "shippingOption": {
-    "id": "c0e5be8f-5266-4720-a732-5f571e4750db",
-    "revision": "2",
-    "createdDate": "2026-04-14T14:43:24.804Z",
-    "updatedDate": "2026-04-15T13:14:13.716Z",
-    "deliveryRegionId": "42b0ed3b-fc54-4ac0-89cf-5d2d17ec441c",
-    "deliveryRegionIds": [],
-    "title": "Updated Standard Shipping",
-    "estimatedDeliveryTime": "3-5 business days",
-    "rates": [
-      {
-        "amount": "9.99",
-        "conditions": [],
-        "multiplyByQuantity": false
-      }
-    ]
-  }
-}
-```
-
-The `revision` field is required and must match the current revision. The response returns the incremented revision.
-
----
-
-## Step 5: Verify the changes
-
-After applying recommendations, query shipping options again (Step 2) to confirm the changes took effect. Verify:
-
-- New options appear in the list with the correct title, rates, and region link
-- Updated options reflect the new values and incremented revision
-- The option is linked to the correct `deliveryRegionId`
-
----
-
-## Error Handling
-
-| Error | Cause | Fix |
-|---|---|---|
-| `deliveryRegionId is not a valid GUID` | Used `deliveryRegionIds` (plural) instead of `deliveryRegionId` (singular) in create request | Use the singular `deliveryRegionId` field |
-| `SHIPPING_OPTION_NOT_FOUND` | The shipping option ID doesn't exist | Re-query shipping options to get current IDs |
-| `REVISION_MISMATCH` | The `revision` doesn't match the current version | Re-fetch the option to get the latest revision, then retry |
-
-## References
-
-- [API: Shipping Delivery](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping)

package/skills/wix-manage/references/ecommerce/skill-graph.md

@@ -1,139 +0,0 @@
----
-name: "eCommerce Skill Graph"
-description: Mermaid diagram showing how eCommerce skills connect — unified strategy entry point, goal/flow/guardrail chain, tracking inlined, troubleshoot as direct entries.
----
-
-## Skill Graph Diagram
-
-```mermaid
-flowchart TB
-    MR["Merchant Request"] --> R
-
-    subgraph R["R — Unified Entry Point"]
-        recommend-ecommerce-strategy
-    end
-
-    R --> |"loads API ref"| Config
-    R --> |"Step 4b: loads matching goal"| Goals
-    R --> |"Step 2+8: tracking inlined"| TrackingAPI
-
-    subgraph Goals["Goals — Business Objectives"]
-        subgraph GD["Discount + Shipping"]
-            goal-increase-aov
-            goal-clear-inventory
-            goal-seasonal-revenue
-            goal-drive-cross-sells
-        end
-        subgraph GA["Abandoned Cart"]
-            goal-reduce-cart-abandonment
-        end
-    end
-
-    Goals --> |"loads matching flows"| Flows
-    goal-increase-aov --> |"also loads shipping flows"| FS
-
-    subgraph Flows["Flows — Business Logic"]
-        subgraph FD["Discount"]
-            flow-upsell-boost
-            flow-bundle-and-save
-            flow-stock-mover
-            flow-seasonal-promotion
-        end
-        subgraph FS["Shipping"]
-            flow-fix-coverage-gaps
-            flow-add-free-shipping
-            flow-optimize-shipping-rates
-        end
-    end
-
-    Flows --> |"loads validation"| Guardrails
-    Flows --> |"loads setup"| Config
-
-    subgraph Guardrails["Cross-cutting: Guardrails"]
-        guardrail-discount-conflicts
-        guardrail-margin-protection
-        guardrail-shipping-health
-        guardrail-rate-pricing-sanity
-    end
-
-    subgraph Config["Config — Setup & API References"]
-        setup-discount-rules
-        setup-coupons
-        setup-shipping-regions
-        setup-shipping-rates
-        api-shipping
-    end
-
-    subgraph TrackingAPI["Tracking API"]
-        api-recommendation-tracking
-    end
-
-    subgraph Standalone["Direct Entry Points (from README)"]
-        recipe-apply-shipping-recommendations
-        setup-store-pickup-location
-        troubleshoot-discount-not-applying
-        troubleshoot-checkout-delivery-dropoff
-    end
-
-    Config -.-> |"calls via CallWixSiteAPI"| API
-
-    subgraph API["Wix REST API Docs (dev.wix.com)"]
-        D1["Discount Rules API"]
-        D2["Coupons API"]
-        D3["Products V3 API"]
-        D4["Categories API"]
-        D5["Catalog Analytics"]
-        S3["Pickup Locations API"]
-        S4["Local Delivery API"]
-        SD["Profile Service API (wix-profile-client)"]
-    end
-
-    classDef goal fill:#8b5cf6,stroke:#6d28d9,color:#fff
-    classDef guardrail fill:#ef4444,stroke:#dc2626,color:#fff
-    classDef flow fill:#3b82f6,stroke:#2563eb,color:#fff
-    classDef config fill:#f59e0b,stroke:#d97706,color:#fff
-    classDef reco fill:#ec4899,stroke:#db2777,color:#fff
-    classDef standalone fill:#6b7280,stroke:#4b5563,color:#fff
-    classDef apidoc fill:#e5e7eb,stroke:#9ca3af,color:#374151
-
-    class goal-increase-aov,goal-clear-inventory,goal-seasonal-revenue,goal-drive-cross-sells,goal-reduce-cart-abandonment goal
-    class guardrail-discount-conflicts,guardrail-margin-protection,guardrail-shipping-health,guardrail-rate-pricing-sanity guardrail
-    class flow-upsell-boost,flow-bundle-and-save,flow-stock-mover,flow-seasonal-promotion,flow-fix-coverage-gaps,flow-add-free-shipping,flow-optimize-shipping-rates flow
-    class setup-discount-rules,setup-coupons,setup-shipping-regions,setup-shipping-rates,api-recommendation-tracking,api-shipping config
-    class recommend-ecommerce-strategy reco
-    class recipe-apply-shipping-recommendations,setup-store-pickup-location,troubleshoot-discount-not-applying,troubleshoot-checkout-delivery-dropoff standalone
-    class D1,D2,D3,D4,D5,S1,S2,S3,S4,SD apidoc
-```
-
-## File Reachability
-
-| File | Reached via |
-|---|---|
-| `recommend-ecommerce-strategy.md` | README routing (entry point) |
-| `api-recommendation-tracking.md` | Entry point tracking steps |
-| `goal-increase-aov.md` | Step 4b (UPSELL_BOOST) |
-| `goal-clear-inventory.md` | Step 4b (STOCK_MOVER) |
-| `goal-seasonal-revenue.md` | Step 4b (SEASONAL) |
-| `goal-drive-cross-sells.md` | Step 4b (BUNDLE_AND_SAVE) |
-| `goal-reduce-cart-abandonment.md` | Step 4b (ABANDONED_CART domain) |
-| `flow-upsell-boost.md` | goal-increase-aov chain |
-| `flow-bundle-and-save.md` | goal-increase-aov / goal-drive-cross-sells chain |
-| `flow-stock-mover.md` | goal-clear-inventory chain |
-| `flow-seasonal-promotion.md` | goal-seasonal-revenue chain |
-| `flow-fix-coverage-gaps.md` | goal-reduce-cart-abandonment chain (critical operational fix) |
-| `flow-add-free-shipping.md` | goal-increase-aov chain (shipping flows serving AOV) |
-| `flow-optimize-shipping-rates.md` | goal-increase-aov chain (shipping flows serving AOV) |
-| `guardrail-discount-conflicts.md` | flow-upsell-boost / bundle / stock / seasonal chains |
-| `guardrail-margin-protection.md` | flow-upsell-boost / stock-mover chains |
-| `guardrail-shipping-health.md` | flow-fix-coverage-gaps chain |
-| `guardrail-rate-pricing-sanity.md` | flow-add-free-shipping / optimize chains |
-| `setup-discount-rules.md` | All discount flow chains |
-| `setup-coupons.md` | Step 4c (COUPON mechanism) |
-| `setup-shipping-regions.md` | flow-fix-coverage-gaps chain |
-| `setup-shipping-rates.md` | flow-add-free-shipping / optimize chains |
-| `api-shipping.md` | Shipping flows (fix-coverage-gaps, add-free-shipping, optimize, recipe, setup-store-pickup) |
-| `recipe-apply-shipping-recommendations.md` | README direct entry |
-| `setup-store-pickup-location.md` | README direct entry |
-| `troubleshoot-discount-not-applying.md` | README direct entry |
-| `troubleshoot-checkout-delivery-dropoff.md` | README direct entry |
-| `skill-graph.md` | Documentation reference |