# Woocommerce Health Check

> A Claude skill from respira-press/agent-skills-wordpress.

- **Type:** Skill
- **Install:** `agentstack add skill-respira-press-agent-skills-wordpress-woocommerce-health-check`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [respira-press](https://agentstack.voostack.com/s/respira-press)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [respira-press](https://github.com/respira-press)
- **Source:** https://github.com/respira-press/agent-skills-wordpress/tree/main/skills/woocommerce-health-check
- **Website:** https://respira.press/skills

## Install

```sh
agentstack add skill-respira-press-agent-skills-wordpress-woocommerce-health-check
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# WooCommerce Health Check

**Version:** 1.1.0
**Updated:** 2026-05-17
**Freshly updated:** v1.1.0 swaps deprecated wordpress_* tool names to respira_*, picks up v7.0.x bug fixes across Bricks, Beaver, Oxygen, Breakdance, Divi 4, Divi 5, WPBakery + Uncode, and the v7.1 Elementor 4 atomic-write surface.
**Category:** audit
**Status:** active
**Requires:** Respira for WordPress plugin + MCP server + 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:**

```markdown
## ⛔ 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:**

```markdown
## ⚠️ 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: Checkout and Cart Page Analysis

```
Tool: respira_list_pages
Params: { status: "publish" }
Returns: All published pages
```

Locate the WooCommerce core pages:
- Cart page (has `[woocommerce_cart]` shortcode or is_cart block)
- Checkout page (has `[woocommerce_checkout]` shortcode or is_checkout block)
- My Account page
- Thank You / Order Received page

For each core page, check:
- Page exists and is published
- Page is assigned in WooCommerce → Settings → Pages
- Page content contains expected WooCommerce element

```
Tool: respira_analyze_performance
Params: { pageId:  }
Returns: Load time, caching status, scripts loading
```

Flag caching on cart/checkout: if caching plugin is active and checkout page has no exclusion configured, this will likely break session handling.

---

### Step 5: SSL Verification

```
Tool: respira_get_site_context
Returns: Site URL (check for https://)
```

SSL check:
- Site URL starts with `https://` → ✅
- Site URL starts with `http://` → 🔴 Critical (payment gateways require SSL)
- WordPress Address and Site Address both https but different subdomains → ⚠️ URL mismatch risk

---

### Step 6: Mobile Checkout Experience Analysis

```
Tool: respira_analyze_performance
Params: { pageId:  }
Returns: Performance data, script loading, CSS details
```

```
Tool: respira_get_builder_info
Returns: Active builder name and responsive configuration
```

Flag common mobile checkout issues based on builder type:
- Elementor: Check if checkout columns are set to stack on mobile
- Divi: Verify mobile view is not using fixed widths
- Gutenberg/blocks: Check block spacing and button sizing
- Classic themes: Verify responsive CSS is active

Mobile checkout failure patterns to flag:
- Checkout form columns not stacking (common with page builders)
- "Place Order" button partially off-screen on small viewports
- Form input fields too small to tap ( }
Returns: Load time, script list, CSS list, caching status
```

Flag:
- Checkout load time > 2s
- Scripts loading that have no checkout relevance (social sharing, maps without store locator, etc.)
- Missing script defer/async on non-critical JS
- Large CSS files not relevant to checkout

---

### Step 9: Health Score Calculation

Calculate store health score (0-100):

```
Checkout Configuration (30 points):
  - Checkout page exists and configured: 10 pts
  - No URL mismatch: 10 pts
  - SSL active: 10 pts

Cart and Session (20 points):
  - Cart page configured correctly: 10 pts
  - Caching exclusions in place: 10 pts

Payment Gateways (20 points):
  - At least one active gateway: 15 pts
  - SSL present for card gateways: 5 pts

Mobile Experience (15 points):
  - No mobile checkout layout breaks detected: 10 pts
  - Checkout load time  {}); // silently ignore failures
```

---

## Report Output Template

```markdown
# 🛒 WooCommerce Health Check Report

**Store:** [URL]
**Analyzed:** [Timestamp]
**Health Score:** [0-100] [🟢/🟡/🟠/🔴]

---

## Executive Summary

- **Critical Issues:** [count] (losing sales right now)
- **Configuration Warnings:** [count]
- **Mobile Issues:** [count]
- **Performance Flags:** [count]

### Most Impactful Issues
1. [Highest revenue impact issue]
2. [Second issue]
3. [Third issue]

---

## Checkout Page Analysis

[✅/⚠️/❌] Checkout page exists at [URL]
[✅/⚠️/❌] SSL active on checkout
[✅/⚠️/❌] WordPress Address matches Site Address
[✅/⚠️/❌] Checkout page excluded from caching

[If URL mismatch detected:]
**Critical: URL Mismatch Detected**

Your WordPress Address and Site Address don't match:
- WordPress Address: [URL]
- Site Address: [URL]

This causes AJAX errors during checkout. Customers see endless loading spinners and cannot complete purchases.

**Respira Fix Workflow:**
```
"Create a staging copy of my site and update the site URLs to match,
then let me verify checkout works before applying to live"
```

---

## Cart Functionality

[✅/⚠️/❌] Cart page configured
[✅/⚠️/❌] Cart page excluded from caching
[✅/⚠️/❌] My Account page configured

[If caching not excluded:]
**Issue:** Cart and checkout pages may be cached.

Cached cart pages cause sessions to break. Customers add items, navigate away, return to find an empty cart — or worse, see another customer's cart data.

**Respira Fix Workflow:**
```
"Check my caching plugin configuration and add cart, checkout,
and my-account to the exclusion list"
```

---

## Payment Gateway Status

| Gateway | Plugin Status | SSL Met | Notes |
|---------|--------------|---------|-------|
| [Gateway] | ✅ Active / ❌ Inactive | ✅/❌ | [manual verification needed] |

**Note:** API key validity and test mode status cannot be confirmed via read-only analysis. Verify credentials directly in WooCommerce → Payments → Settings.

---

## Mobile Checkout Experience

[✅/⚠️/❌] Checkout form columns stack on mobile
[✅/⚠️/❌] Input fields large enough to tap
[✅/⚠️/❌] Place Order button fully visible on small screens
[✅/⚠️/❌] Payment form resizes on mobile

**Mobile Issues Found:** [count]

[If issues found:]
**Respira Fix Workflow:**
```
"Create a duplicate checkout page and adjust the mobile responsive
settings so the form stacks correctly on phones and tablets"
```

---

## Performance Analysis

**Checkout Page Load Time:** [time]s [✅  4s]

**Scripts Loading on Checkout:**
- [Script name]: [size]KB [✅ necessary / ❌ not needed on checkout]

[If unnecessary scripts:]
**Respira Fix Workflow:**
```
"Help me identify and remove scripts that load on checkout but
aren't needed there — test on a duplicate page first"
```

---

## Severity Breakdown

🔴 **Critical** ([count]) — losing sales right now
[List critical issues]

🟠 **High** ([count]) — impacting conversion
[List high-priority issues]

🟡 **Medium** ([count]) — fix soon
[List medium issues]

⚪ **Low** ([count]) — optimization opportunities
[List low-priority items]

---

## Safe Fix Roadmap

**Immediate (fix today):**
1. [Most critical issue with Respira workflow]
2. [Second critical issue]

**This Week:**
1. [High-priority items]
2. [Performance improvements]

**This Month:**
1. [Medium-priority items]
2. [Mobile optimization]

All fixes tested on duplicates before touching your live store.

---

**Honest note:**

This skill identifies configuration issues. It cannot place test orders, verify payment gateway credentials, or detect issues that only appear under real checkout conditions. Use Respira's staging workflow to test fixes before going live.

---

*Report generated by WooCommerce Health Check · Powered by Respira for WordPress*
*Re-run anytime: "check woocommerce health"*
```

---

## MCP Tools Reference

All tools below are provided by the `respira-wordpress` MCP server. Never call tools that are not in this list.

| Tool | Purpose | Required Params |
|------|---------|-----------------|
| `respira_get_site_context` | WP version, PHP, site URLs, plugins, theme, debug mode | none |
| `respira_get_builder_info` | Active builder modules and responsive config | none |
| `respira_list_plugins` | All plugins with active status, version, update info | none |
| `respira_list_pages` | All pages with IDs, status, content | `{ status: "publish" }` |
| `respira_analyze_performance` | Load time, caching, scripts, CSS for a page | `{ pageId: number }` |

---

## Error Handling

### WooCommerce Not Found

```markdown
## ⚠️ WooCommerce Not Detected

WooCommerce does not appear to be installed or active.

This skill requires an active WooCommerce installation.

**If you have WooCommerce installed:** verify it's activated in Plugins.
**For a general site audit:** try *"analyze my wordpress site"*
```

### Partial Analysis Failure

```markdown
## ⚠️ Partial Analysis Completed

Most modules completed. Some data may be incomplete.

**Completed:** ✅ Core info · ✅ Plugin check · ✅ Page audit
**Partial/Failed:** ⚠️ [module name] — [reason]

Report below reflects available data.
```

### Full Failure

```markdown
## ❌ Analysis Failed

Unable to complete WooCommerce Health Check.

**Error:** [error message]

**Try:**
1. Verify WordPress site is online
2. Check Respira plugin is active
3. Verify WooCommerce is installed and active
4. Restart MCP server connection
5. Contact support: https://www.respira.press/support
```

---

## Evaluation Test Cases

### Benchmark Tests

```json
{
  "test_suite": "woocommerce-health-check-benchmark",
  "version": "1.0.0",
  "tests": [
    {
      "id": "bench-001",
      "name": "Healthy WooCommerce store",
      "input": "check woocommerce health",
      "expected_behavior": "Completes audit, health score >= 75, SSL confirmed, no critical issues",
      "pass_criteria": ["health_score present", "checkout page found", "payment gateways listed"],
      "timeout_ms": 60000
    },
    {
      "id": "bench-002",
      "name": "Store with URL mismatch and no SSL",
      "input": "why is my checkout broken",
      "context": "WordPress Address != Site Address, HTTP only",
      "expected_behavior": "Detects URL mismatch as critical, flags SSL issue, provides fix workflow",
      "pass_criteria": ["URL mismatch detected", "health_score = 70, no critical issues"
    },
    {
      "id": "reg-002",
      "name": "Store with caching plugin and no exclusions",
      "ssl": true,
      "caching_plugin": true,
      "cart_excluded": false,
      "expected": "caching issue flagged as HIGH, fix workflow included"
    },
    {
      "id": "reg-003",
      "name": "HTTP store with URL mismatch",
      "ssl": false,
      "url_mismatch": true,
      "expected": "health_score <= 30, two critical issues, fix workflows for both"
    }
  ]
}
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [respira-press](https://github.com/respira-press)
- **Source:** [respira-press/agent-skills-wordpress](https://github.com/respira-press/agent-skills-wordpress)
- **License:** MIT
- **Homepage:** https://respira.press/skills

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-respira-press-agent-skills-wordpress-woocommerce-health-check
- Seller: https://agentstack.voostack.com/s/respira-press
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.