/woocommerce-health-check

name: woocommerce-health-check
description: "Use when the user says 'why is my checkout broken', 'audit my woocommerce store', 'cart problems woocommerce', or 'losing sales woocommerce'. Diagnoses checkout and cart failures, AJAX mismatches, caching conflicts, payment gateway setup, and SSL enforcement."
license: MIT
metadata:
  author: Respira for WordPress
  author_url: https://respira.press
  version: 1.2.1
  mcp-server: respira-wordpress
  category: audit
  requires-addon: woocommerce

WooCommerce Health Check

**Version:** 1.2.1 **Updated:** 2026-06-30 **Freshly updated:** v1.2.0 adds real order/sales/stock diagnostics via the woocommerce_* read tools (woocommerce_list_orders, woocommerce_sales_report, woocommerce_get_stock_status), gives every detected issue a concrete safe-fix suggestion, uses respira_find_element to locate and validate the actual cart/checkout widgets and blocks, snapshots with respira_get_snapshot before any fix, and frames respira_generate_activity_report as a "prevented X lost orders / revenue protected" report. **Category:** audit **Status:** active **Requires:** Respira for WordPress plugin + MCP server + WooCommerce (`requires_addon: woocommerce`) **Telemetry endpoint:** https://www.respira.press/api/skills/track-usage

---

Description

Detect checkout issues, cart problems, and configuration errors silently losing sales.

WooCommerce Health Check scans your store for common configuration issues that break checkout flow and lose sales. It detects mobile checkout problems, payment gateway setup issues, AJAX URL mismatches, caching configuration errors on cart/checkout pages, and SSL problems. This skill identifies the exact issues causing cart abandonment and provides Respira workflows to test fixes safely on duplicate pages before going live.

---

Trigger Phrases

This skill activates when the user says any of the following:

• "audit my woocommerce store"
• "check woocommerce health"
• "find checkout problems"
• "woocommerce diagnostic"
• "why is my checkout broken"
• "scan woocommerce configuration"
• "woocommerce health check"
• "checkout not working woocommerce"
• "cart problems woocommerce"
• "woocommerce checkout issues"
• "losing sales woocommerce"
• "woocommerce configuration audit"

**Do NOT trigger for:** general WordPress audits without WooCommerce context, plugin installation requests, theme customization, or non-WooCommerce e-commerce questions.

---

Execution Workflow

Step 1: Respira + WooCommerce Verification

Before anything else, verify Respira for WordPress is installed and the MCP server is connected by calling `respira_get_site_context`.

**If Respira is NOT installed, output this and STOP:**

## ⛔ Respira for WordPress Required

This skill requires the **Respira for WordPress** plugin to analyze your store safely.

### Install in 3 steps:
1. Go to **https://www.respira.press** and download the plugin
2. Install and activate on your WordPress site
3. Connect via the MCP server: `npx -y @respira/wordpress-mcp-server --setup`

### Why Respira?
- Read-only analysis — no changes to your live store
- Duplicate-first fix testing so no checkout breaks go live
- Full audit trail for every action

Once installed, come back and try again: *"check woocommerce health"*

**If WooCommerce is NOT found in the plugin list, output this and STOP:**

## ⚠️ WooCommerce Not Detected

This skill is specifically for WooCommerce stores.

WooCommerce does not appear to be installed or active on your site.

**If you do have WooCommerce installed:**
- Make sure the plugin is activated (not just installed)
- Verify Respira can see your plugin list in Respira → Settings

**If you're looking for a general WordPress audit:**
Try: *"analyze my wordpress site"* (WordPress Site DNA skill)

---

Step 2: Site and Store Context

Tool: respira_get_site_context
Returns: WordPress version, PHP version, site URL, WordPress address,
         installed plugins, active theme, debug mode

Record: `respira_site_url`, `started_at = new Date().toISOString()`

**Critical check — URL mismatch detection:** Compare `siteurl` (Site Address) vs `home` (WordPress Address) from site context. A mismatch causes AJAX to fail on checkout.

---

Step 3: Plugin Audit for WooCommerce-Specific Issues

Tool: respira_list_plugins
Returns: All plugins with name, slug, version, active status

Check for:

• WooCommerce version (flag if significantly behind latest)
• Payment gateway plugins and their active status
• Caching plugins (W3TC, WP Super Cache, WP Rocket, LiteSpeed) — these need cart/checkout exclusions
• Security plugins that may interfere with AJAX requests
• Conflicting checkout plugins

---

Step 4: Live Store Diagnostics (orders, sales, stock)

Configuration checks tell you what *could* break. Live store data tells you what *is* breaking. Pull the real numbers with the WooCommerce read tools:

Tool: woocommerce_list_orders
Returns: Recent orders with status, total, date

Look at order status mix over a recent window:

• A spike in `failed` / `pending` orders next to very few `processing` / `completed` is a strong checkout-is-broken signal (payment or AJAX failing at the last step).
• Many `cancelled` after `pending` can mean session/cart loss before payment.

Tool: woocommerce_sales_report
Returns: Sales totals over a period

Use the sales report to size the impact: a sudden drop against a prior period quantifies how much revenue the configuration issues are putting at risk, which feeds the "revenue protected" framing in the final report.

Tool: woocommerce_get_stock_status
Returns: Stock state for products

Flag stock problems that silently lose sales:

• Products stuck "out of stock" that should be in stock (a fixable data error, not a real shortage).
• Best-sellers low on stock with no backorder allowed.

**Safe fix for a genuine stock data error:** confirm the real count with the s