New skills routing

skills/wix-manage/SKILL.md

@@ -108,72 +108,125 @@ These recipes do NOT cover frontend development or SDK usage for displaying data
 
 ## eCommerce
 
-**Routing — pick the right entry point:**
-- **Any sales/business improvement request** (boost sales, promotions, help my business, holiday deals, improve revenue, discounts, shipping, coupons, clearance) → use [Recommend: eCommerce Strategy](references/ecommerce/recommend-ecommerce-strategy.md). This is the **default entry point** — it analyzes ALL domains (discounts, shipping, future: gift cards, taxes) and generates cross-domain recommendations. Do NOT ask clarifying questions.
-- **Apply previously generated shipping recommendations** → use [Recipe: Apply Shipping Recommendations](references/ecommerce/recipe-apply-shipping-recommendations.md)
-- **Store pickup configuration** → use [Setup Store Pickup Location](references/ecommerce/setup-store-pickup-location.md)
-- **Discount not working at checkout** → use [Troubleshoot: Discount Not Applying](references/ecommerce/troubleshoot-discount-not-applying.md)
-- **Checkout delivery step drop-off** → use [Troubleshoot: Checkout Delivery Drop-off](references/ecommerce/troubleshoot-checkout-delivery-dropoff.md)
+**Routing structure** (rules + format in the `wix-skills-routing-expert` Claude Code skill — repo `ecom-ai-agents/.claude/skills/`): Each L2 category has a sibling `<category>.md` (README-surfaced description) + a `<category>/` folder with the dispatcher + promotion files. The migrated eCommerce L2 categories are **Tax**, **Pricing & promotions**, **Shipping**, **Checkout & cart**, **Abandoned carts**, **Fulfillment**, and **Orders**.
 
-### [Recommend: eCommerce Strategy](references/ecommerce/recommend-ecommerce-strategy.md)
-**THE entry point for all eCommerce recommendation requests.** Unified skill that analyzes site data across ALL domains (discounts + shipping), generates up to 5 cross-domain recommendations, and persists them to the tracking database. Covers discount strategies (seasonal, upsell, stock mover, bundling) AND shipping optimization (coverage gaps, free shipping, rate strategy, carrier backup). Use this for ANY business improvement request.
+**L1 context loader (per L1 domain, sibling to category-docs):**
 
-### [Recipe: Apply Shipping Recommendations](references/ecommerce/recipe-apply-shipping-recommendations.md)
-**Technical:** Applies AI-generated shipping recommendations. Creates or updates shipping options based on recommendation data.
+### [eCommerce: Load Context](references/ecommerce/ecom-load-context.md)
+Per-L1 context loader for the eCommerce domain. Loads site profile (country, region, industry, currency, AOV, etc.) + eCommerce-specific runtime fields (tax `calculator`). Referenced from every eCommerce category's `default.md`. Skip if already loaded.
 
-### [Setup Store Pickup Location](references/ecommerce/setup-store-pickup-location.md)
-**Technical:** Configures in-store pickup at checkout using Delivery Profiles API.
+When other L1 domains migrate (Stores, Get-paid, …), each gets its own `<l1>-load-context.md` at its L1 root — Stores will detect Catalog V1/V3, Get-paid will inspect payment provider state, etc. See the "Pattern for future L1 loaders" section in `ecom-load-context.md` for the convention.
 
-### [Troubleshoot: Discount Not Applying](references/ecommerce/troubleshoot-discount-not-applying.md)
-**Technical:** Diagnostic tree for inactive discounts — checks active status, time window, scope targeting, revision mismatch, app installation.
+---
+
+### Tax category
+
+#### [Tax](references/ecommerce/ecom-tax.md)
+README-surfaced category-doc **and** dispatcher (merged — prototype). Disambiguates the category, then picks Avalara / EU-VAT / Wix-Manual / audit / troubleshoot / switch based on the merchant's request + MerchantContext. No separate `-default` hop.
+
+#### Tax promotions
+- [Configure Tax (Wix Manual)](references/ecommerce/tax/ecom-tax-configure.md) — baseline manual calculator setup
+- [Configure Tax (Avalara)](references/ecommerce/tax/ecom-tax-avalara.md) — context promotion `[calculator:AVALARA]`
+- [Configure Tax (EU VAT)](references/ecommerce/tax/ecom-tax-eu-vat.md) — context promotion `[region:EU]`
+- [Switch Tax Calculator](references/ecommerce/tax/ecom-tax-switch-calculator.md)
+- [Audit Tax Setup](references/ecommerce/tax/ecom-tax-audit.md) (read-only)
+- [Tax Calculation Wrong](references/ecommerce/tax/ecom-tax-troubleshoot-calc-wrong.md) (diagnostic)
+
+---
+
+### Pricing & Promotions category
+
+#### [Pricing & Promotions](references/ecommerce/ecom-pricing.md)
+README-surfaced category-doc **and** dispatcher (merged). Disambiguates the category, then picks the right Pricing promotion based on the merchant's intent + MerchantContext. No separate `-default` hop.
 
-### [Troubleshoot: Checkout Delivery Drop-off](references/ecommerce/troubleshoot-checkout-delivery-dropoff.md)
-**Technical:** Diagnostic tree for delivery step conversion below 65% benchmark.
+#### Pricing promotions (direct merchant entry points)
+- [Create Coupon](references/ecommerce/pricing-promotions/ecom-pricing-create-coupon.md) — Coupons V2 API
+- [Create Discount Rule](references/ecommerce/pricing-promotions/ecom-pricing-create-discount-rule.md) — auto-apply discount rules
+- [Run a Sale (orchestrator)](references/ecommerce/pricing-promotions/ecom-pricing-run-a-sale.md) — the cross-domain strategy orchestrator (formerly `recommend-ecommerce-strategy`)
+- [Discount Not Applying](references/ecommerce/pricing-promotions/ecom-pricing-troubleshoot-not-applying.md) — diagnostic tree
 
 <details>
-<summary>Internal skills (loaded automatically by the entry points above — do NOT use directly)</summary>
-
-#### Goals
-- [Goal: Increase AOV](references/ecommerce/goal-increase-aov.md) — UPSELL_BOOST
-- [Goal: Clear Inventory](references/ecommerce/goal-clear-inventory.md) — STOCK_MOVER
-- [Goal: Seasonal Revenue](references/ecommerce/goal-seasonal-revenue.md) — SEASONAL
-- [Goal: Drive Cross-Sells](references/ecommerce/goal-drive-cross-sells.md) — BUNDLE_AND_SAVE
-- [Goal: Reduce Cart Abandonment](references/ecommerce/goal-reduce-cart-abandonment.md) — Shipping
-
-#### Flows
-- [Flow: Upsell Boost](references/ecommerce/flow-upsell-boost.md)
-- [Flow: Bundle and Save](references/ecommerce/flow-bundle-and-save.md)
-- [Flow: Stock Mover](references/ecommerce/flow-stock-mover.md)
-- [Flow: Seasonal Promotion](references/ecommerce/flow-seasonal-promotion.md)
-- [Flow: Fix Coverage Gaps](references/ecommerce/flow-fix-coverage-gaps.md)
-- [Flow: Add Free Shipping](references/ecommerce/flow-add-free-shipping.md)
-- [Flow: Optimize Shipping Rates](references/ecommerce/flow-optimize-shipping-rates.md)
-
-#### Guardrails
-- [Guardrail: Discount Conflicts](references/ecommerce/guardrail-discount-conflicts.md)
-- [Guardrail: Margin Protection](references/ecommerce/guardrail-margin-protection.md)
-- [Guardrail: Shipping Health](references/ecommerce/guardrail-shipping-health.md)
-- [Guardrail: Rate Pricing Sanity](references/ecommerce/guardrail-rate-pricing-sanity.md)
-
-#### Config & API References
-- [API: Recommendation Tracking](references/ecommerce/api-recommendation-tracking.md)
-- [API: Shipping Delivery](references/ecommerce/api-shipping.md)
-- [Setup: Discount Rules](references/ecommerce/setup-discount-rules.md)
-- [Setup: Coupons](references/ecommerce/setup-coupons.md)
-- [Setup: Shipping Regions](references/ecommerce/setup-shipping-regions.md)
-- [Setup: Shipping Rates](references/ecommerce/setup-shipping-rates.md)
-
-#### Tracking
-- Tracking is built into [Recommend: eCommerce Strategy](references/ecommerce/recommend-ecommerce-strategy.md) (Steps 2 + 8) — no separate skill needed
-- [API: Recommendation Tracking](references/ecommerce/api-recommendation-tracking.md) — CRUD API reference for the tracking service
+<summary>Pricing support files (goal-* / flow-* / guardrail-* / tracking-api) — flat in pricing-promotions/, loaded by the orchestrator, NOT direct entry points</summary>
 
-#### Reference
-- [Skill Graph](references/ecommerce/skill-graph.md)
+- [Goal: Increase AOV](references/ecommerce/pricing-promotions/ecom-pricing-goal-increase-aov.md) — UPSELL_BOOST
+- [Goal: Clear Inventory](references/ecommerce/pricing-promotions/ecom-pricing-goal-clear-inventory.md) — STOCK_MOVER
+- [Goal: Seasonal Revenue](references/ecommerce/pricing-promotions/ecom-pricing-goal-seasonal-revenue.md) — SEASONAL
+- [Goal: Drive Cross-Sells](references/ecommerce/pricing-promotions/ecom-pricing-goal-drive-cross-sells.md) — BUNDLE_AND_SAVE
+- [Flow: Upsell Boost](references/ecommerce/pricing-promotions/ecom-pricing-flow-upsell-boost.md)
+- [Flow: Bundle and Save](references/ecommerce/pricing-promotions/ecom-pricing-flow-bundle-and-save.md)
+- [Flow: Stock Mover](references/ecommerce/pricing-promotions/ecom-pricing-flow-stock-mover.md)
+- [Flow: Seasonal Promotion](references/ecommerce/pricing-promotions/ecom-pricing-flow-seasonal-promotion.md)
+- [Pricing & Discount Health](references/ecommerce/pricing-promotions/ecom-pricing-health.md) — periodic conflict/stale-sale/margin sweep
+- [API: Recommendation Tracking](references/ecommerce/pricing-promotions/ecom-pricing-tracking-api.md)
+
+(Discount-conflict & margin guardrails are inlined into Create Discount Rule / Create Coupon — the skills they guard — rather than separate files.)
 
 </details>
 
 ---
 
+### Shipping category
+
+#### [Shipping](references/ecommerce/ecom-shipping.md)
+README-surfaced category-doc **and** dispatcher (merged). Covers shipping config — rates, regions/coverage, pickup/local delivery, free-shipping thresholds, rate optimization, and wrong-rate troubleshooting. Order-fulfillment ops — mark fulfilled, tracking, labels — belong to **Fulfillment**. The Shipping Options + Delivery Profiles APIs have no public docs page, so `ecom-shipping-api.md` is the inline reference.
+
+#### Shipping promotions
+- [Set Up Rates](references/ecommerce/shipping/ecom-shipping-setup-rates.md)
+- [Set Up Regions / Coverage](references/ecommerce/shipping/ecom-shipping-setup-regions.md)
+- [Set Up Pickup / Local Delivery](references/ecommerce/shipping/ecom-shipping-setup-pickup.md)
+- [Add Free Shipping](references/ecommerce/shipping/ecom-shipping-free-shipping.md)
+- [Optimize Rates](references/ecommerce/shipping/ecom-shipping-optimize-rates.md)
+- [Fix Coverage Gaps](references/ecommerce/shipping/ecom-shipping-fix-coverage.md)
+
+#### Shipping support (loaded via body links, not direct entries)
+- [API Reference](references/ecommerce/shipping/ecom-shipping-api.md) — inline spec (no public docs page)
+
+(Rate-pricing-sanity and shipping-health guardrails are inlined into their caller recipes — free-shipping / optimize-rates and fix-coverage. The generic "apply shipping recommendations" recipe was dissolved — the LLM applies recs directly via the create/update endpoints in the API Reference.)
+
+### Checkout & Cart category
+
+#### [Checkout & Cart](references/ecommerce/ecom-checkout.md)
+README-surfaced category-doc **and** dispatcher (merged). Covers live checkout abandonment reduction, checkout troubleshooting, agentic readiness, and store-health. Abandoned-checkout recovery after the shopper leaves belongs to **Abandoned carts**. Most checkout *config* (guest checkout, minimum order, custom fields, upsell) is **Dashboard-only** — the dispatch routes those to the Wix Dashboard.
+
+#### Checkout promotions
+- [Reduce Abandonment](references/ecommerce/checkout/ecom-checkout-reduce-abandonment.md) — delivery-step friction angle; also loaded by run-a-sale's ABANDONED_CART branch
+- [Troubleshoot Delivery Drop-off](references/ecommerce/checkout/ecom-checkout-troubleshoot-dropoff.md)
+- [Agentic Readiness](references/ecommerce/checkout/ecom-checkout-agentic-readiness.md) — catalog data-quality audit + programmatic test-checkout (AI agents)
+- [Store Health Monitor](references/ecommerce/checkout/ecom-checkout-store-health.md) — periodic checkout/config-drift/anomaly checks
+
+### Abandoned Carts category
+
+#### [Abandoned Carts](references/ecommerce/ecom-abandoned-carts.md)
+README-surfaced category-doc **and** dispatcher (merged). Covers abandoned-checkout recovery and recapture after the shopper leaves: viewing abandoned checkouts, recovery emails, recovery links, troubleshooting recovery, and recovery health monitoring.
+
+#### Abandoned Carts promotions
+- [Recover Abandoned Carts via Email](references/ecommerce/abandoned-carts/ecom-abandoned-carts-recover-email.md) — Dashboard-configured automation; recipe guides timing/content/eligibility
+- [Generate Recovery Link](references/ecommerce/abandoned-carts/ecom-abandoned-carts-recovery-link.md) — Abandoned Checkout API link generation
+- [Troubleshoot Recovery](references/ecommerce/abandoned-carts/ecom-abandoned-carts-troubleshoot-recovery.md)
+- [Recovery Health Monitor](references/ecommerce/abandoned-carts/ecom-abandoned-carts-recovery-health.md)
+
+### Fulfillment category
+
+#### [Fulfillment](references/ecommerce/ecom-fulfillment.md)
+README-surfaced category-doc **and** dispatcher (merged). Covers post-purchase fulfillment operations: finding unshipped/problematic orders, marking orders fulfilled, updating tracking, partial fulfillment, bulk fulfillment, invoices/packing slips, and Dashboard-only shipping labels.
+
+#### Fulfillment promotions
+- [Fulfill Orders & Tracking](references/ecommerce/fulfillment/ecom-fulfillment-fulfill-orders.md) — mark fulfilled, tracking, partial fulfillment
+- [Bulk Fulfill Orders](references/ecommerce/fulfillment/ecom-fulfillment-bulk-fulfill-orders.md) — batch fulfillment with partial-failure handling
+
+### Orders category
+
+#### [Orders](references/ecommerce/ecom-orders.md)
+README-surfaced category-doc **and** dispatcher (merged). Covers eCommerce order lookup, order details/counts, order search, pending/stuck-order diagnosis, cancel-order routing, and explicit handoffs to Fulfillment and Payments.
+
+#### Orders promotions
+- [Cancel Order](references/ecommerce/orders/ecom-orders-cancel-order.md) — cancel order with restock/email/refund guardrails
+
+#### Reference
+- [Skill Graph](references/ecommerce/skill-graph.md) — author docs only, NOT a runtime skill
+
+---
+
 ## Forms
 
 ### [Create Form](references/forms/create-form.md)

skills/wix-manage/references/ecommerce/abandoned-carts/ecom-abandoned-carts-recover-email.md

@@ -0,0 +1,81 @@
+---
+name: "Abandoned Carts: Recover via Email"
+description: Sets up automated abandoned-cart / abandoned-checkout recovery emails. Covers Wix Dashboard automation, send timing, email content, eligibility, recovery-rate benchmarks, and when to use API-generated recovery links instead.
+---
+
+# Recover Abandoned Carts via Email
+
+Set up an automated email that follows up with shoppers who started but did not finish checkout. This is the **email-recovery** lever. If the merchant wants to fix why shoppers leave during checkout, route to [Reduce Abandonment](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/checkout-reduce-abandonment).
+
+Merchants often say "abandoned carts"; the public API calls them **Abandoned Checkouts**.
+
+> **Where this is configured.** The recurring recovery email automation is a built-in Wix automation set up in the Dashboard. The trigger -> send path is not a verified TPA-public API. Use Analytics APIs for reporting questions. Use the Abandoned Checkout API for record-level verification, automation activity inspection, or redirecting a shopper back to checkout for custom flows.
+
+## API and Dashboard status
+
+| Capability | Route | Status |
+|---|---|---|
+| Configure recurring abandoned-cart email automation | Wix Dashboard -> Marketing -> Automations | Dashboard-managed |
+| Measure recovery performance or abandoned-cart trends | Analytics Data API / Semantic Model API | Site Analytics read |
+| Inspect specific buyer/status/activity fields | `POST https://www.wixapis.com/ecom/v1/abandoned-checkout/query` | TPA-public, drill-down |
+| Redirect shopper back to checkout for a one-off custom message | `GET https://www.wixapis.com/ecom/v1/abandoned-checkout/{abandonedCheckoutId}/redirect-to-checkout?metasiteId={metasiteId}` | TPA-public |
+
+## Required APIs for verification only
+
+- `POST https://www.wixapis.com/ecom/v1/abandoned-checkout/query` — list eligible abandoned checkouts, filter by date/status/buyer, and inspect automation `activities` when available.
+- `GET https://www.wixapis.com/ecom/v1/abandoned-checkout/{abandonedCheckoutId}` — verify a specific checkout before using it in a custom recovery flow.
+
+## Prerequisites
+
+- Wix Stores or another eCommerce solution is installed.
+- A sender email / verified business email is connected.
+- Checkout captures a customer email. Guest checkouts without an email cannot be recovered by email.
+
+## Step 1: Enable the abandoned-cart automation
+
+Direct the merchant to the built-in automation:
+
+> **Wix Dashboard -> Marketing -> Automations**. Find the pre-built **Recover abandoned carts** automation and turn it on. If it does not exist, create a new automation with:
+> - **Trigger:** Abandoned checkout / cart (eCommerce)
+> - **Action:** Send an email to the shopper
+
+## Step 2: Set the send timing
+
+| Timing | Use | Notes |
+|---|---|---|
+| 1 hour after abandonment | Single-email default | Catches distracted shoppers while intent is fresh |
+| 1 hour + 24 hours | Higher recovery | Second nudge for price or shipping hesitation |
+| +72 hours with incentive | Optional third email | Only if margins allow a small discount |
+
+Avoid sending more than about three emails. Beyond that, unsubscribes usually outweigh recoveries.
+
+## Step 3: Write the recovery email
+
+Include, in priority order:
+
+1. Cart contents, such as product image and name.
+2. A clear "Complete your order" button.
+3. Reassurance, such as shipping policy, return policy, or support contact.
+4. Optional incentive, such as a small discount or free-shipping nudge.
+
+## Step 4: Eligibility and guardrails
+
+- **Consent:** Respect marketing opt-out flags.
+- **No double-send:** Do not send recovery email for checkouts that converted.
+- **Discount stacking:** If the email includes an incentive, confirm it will not stack with existing automatic discounts.
+- **Email captured only:** If the checkout did not capture an email, use broader checkout optimization instead of email recovery.
+
+## Measurement
+
+- **Recovery rate** = recovered abandoned checkouts / abandoned checkouts that were eligible for recovery.
+- Use Analytics APIs for recovery performance, abandonment trends, and reporting. For custom reports, discover the relevant Semantic Model fields first and do not invent a ready-made "recovery rate" field unless the analytics model exposes it.
+- Use 5-15% as a rough benchmark, but do not claim any API returns a single ready-made "recovery rate" field unless it is present in the data you queried.
+- Track over 30 days. If recovery is below 5%, revisit timing, subject line, cart rendering, eligibility, and whether the checkout redirect still works.
+
+## API-assisted path
+
+For a custom recovery flow, use [Generate a recovery link / resume checkout](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/abandoned-carts-recovery-link). Prefer the Dashboard automation for recurring email sends because it handles consent, throttling, and send orchestration.
+
+## Audit note
+
+This file is not redundant with the public API docs because the public API does not configure Wix Automations. The value of this skill is the Dashboard/API boundary, timing guidance, eligibility guardrails, and when to switch to the API-assisted recovery-link recipe.