---
name: woocommerce-store-audit
description: Use when asked to audit a WooCommerce store connected via Cowboy MCP — reviews sales, stock, stuck orders, coupons, and checkout settings read-only, then reports findings and proposed fixes without changing anything unless explicitly told to.
---

# WooCommerce store audit

Inspect the health of a WooCommerce store through Cowboy MCP and hand the owner an evidence-backed findings report. This skill is read-heavy by design: it audits, reports, and proposes fixes. It does not change stock, orders, products, coupons, or settings unless the owner explicitly asks — and then only behind a checkpoint.

## Before you start

1. Confirm WooCommerce is active: call `wp_woo_report_orders_by_status`. If the WooCommerce tools are missing or return nothing, WooCommerce is not active — stop and tell the owner.
2. Agree on a reporting window (for example, the last 30 days) for the sales and revenue reports.
3. Do not take a checkpoint yet — the audit only reads. A checkpoint is only needed if the owner later approves a write (see Notes).

## Steps (all read-only)

1. **Sales health.** Call `wp_woo_report_sales` for the agreed date range (revenue, order count, items sold, refunds, tax, shipping) and `wp_woo_report_revenue_by_date` for the daily trend.
2. **Order pipeline.** Call `wp_woo_report_orders_by_status` for counts by status, then `wp_woo_list_orders` filtered to `processing`, `on-hold`, and `pending` to find orders stuck unpaid or unfulfilled.
3. **Best and worst sellers.** Call `wp_woo_report_top_products` for the period's top sellers by quantity and by revenue.
4. **Inventory.** Call `wp_woo_list_products` and flag every item whose `stock_status` is `outofstock` or whose `stock_quantity` is low. Use `wp_woo_get_product` and `wp_woo_list_variations` to drill into variable products.
5. **Coupons.** Call `wp_woo_list_coupons` and note expired coupons still enabled and any close to their usage limit.
6. **Customers.** Call `wp_woo_report_customer_stats` for new-versus-returning counts and top spenders.
7. **Checkout config.** Call `wp_woo_list_payment_gateways` (which are enabled), `wp_woo_get_tax_rates`, and `wp_woo_list_shipping_zones` to spot missing or misconfigured checkout settings.

## Notes

- Every tool above is read-only and changes nothing. Running the full audit is always safe.
- The fix tools exist but are out of scope for the audit itself: `wp_woo_manage_stock` (bulk stock), `wp_woo_update_product`, and `wp_woo_update_order`. Only call them if the owner explicitly approves a specific change — and take a `wp_create_checkpoint` first, then run the tool with `dry_run: true` before applying.
- `wp_woo_list_products` has no stock filter; it returns stock fields per item, so filter the returned list yourself rather than expecting a low-stock query parameter.

## Report format

Summarize back to the store owner:
- Sales for the window: revenue, orders, refunds, and the day-by-day trend.
- Orders needing attention: each stuck or unpaid order with its status and age.
- Inventory: out-of-stock and low-stock items (and variations), listed individually.
- Coupons and checkout: expired coupons still live, and any payment, tax, or shipping gaps.
- A proposed fix list, each item marked awaiting your approval — nothing was changed.