Ira Bodnar··Updated ·12 min read

Claude Skills for WooCommerce: 10 SKILL.md Files + Prompts

Quick answer: Save each recurring store task as a Claude skill that names the WooCommerce REST API path to read. Ryze AI is the best Claude connector for running these skills on a live WooCommerce store in 2026, with one caveat: it holds one store per workspace.

Below: 10 SKILL.md files, the REST API fields each uses, install steps and quick prompts.

Ryze AI · Paid Ads

WooCommerce skills on live store data

  • 7-day free trial, $89 a month flat

Used by 2,000+ marketers

Uber Eats logoadidas logoDuolingo logoMGM Resorts logoWharton logoLendingClub logoNorton logoEventbrite logoHuel logoTogether AI logoghd logoHack The Box logo

The 10 Claude skills for WooCommerce at a glance

Eight are read-only and need only a Read key. Two make changes and need a Read/Write key.

  1. 01Weekly store recapOrders and revenue against last week

    Main REST path: orders, reports/sales

    Key needed: Read

  2. 02Top sellersBest products by units and revenue

    Main REST path: reports/top_sellers, products

    Key needed: Read

  3. 03Refund reviewRefunds and the orders behind them

    Main REST path: refunds, orders

    Key needed: Read

  4. 04Order queueOrders stuck in pending, on-hold or failed

    Main REST path: orders

    Key needed: Read

  5. 05Stock watchOut-of-stock and low-stock products

    Main REST path: products

    Key needed: Read

  6. 06Catalog auditDrafts, private items and missing prices

    Main REST path: products

    Key needed: Read

  7. 07Coupon auditCoupon usage, limits and expiry

    Main REST path: coupons, reports/coupons/totals

    Key needed: Read

  8. 08Customer ordersRepeat buyers and first-time buyers

    Main REST path: orders, customers

    Key needed: Read

  9. 09Price and stock updateChange prices or stock after you confirm

    Main REST path: products

    Key needed: Read/Write

  10. 10Coupon launch and cleanupCreate a coupon, retire expired ones

    Main REST path: coupons

    Key needed: Read/Write

The REST paths and field names come from the WooCommerce REST API v3 documentation. No store numbers appear on this page, and the steps inside Claude were not run by this page.

What are Claude skills for WooCommerce?

A Claude skill for WooCommerce is a saved SKILL.md file that tells Claude which store data to pull and what to hand back. Per Anthropic's Agent Skills docs, the file starts with a name and a description, and Claude loads the rest when a request matches the description.

The name allows up to 64 characters, only lowercase letters, numbers and hyphens, and cannot contain the reserved words anthropic or claude, so every skill here starts with woo. The description is limited to 1,024 characters and says what the skill does and when to use it.

  1. What it is

    One-off prompt
    A question in chat
    Skill
    A saved file with fixed paths and a fixed output
    Store connection
    The tools Claude uses to reach your store
  2. Setup

    One-off prompt
    None
    Skill
    Save once per Claude app
    Store connection
    One REST API key, one connector URL
  3. Same result each run

    One-off prompt
    No
    Skill
    Yes
    Store connection
    Depends on the prompt or skill

Skills reference the WooCommerce REST API v3 by resource path and field name. Without a connection, attach an order or product export with the same columns.

How to install the skills in Claude

Claude Code

Save each block as ~/.claude/skills/<skill-name>/SKILL.md for yourself, or .claude/skills/<skill-name>/SKILL.md in a project. Anthropic lists both folders as the places for custom skills in Claude Code, and you can type /woo-weekly-recap to run one (Claude Code skills docs).

claude.ai

Zip each skill folder and upload it as a custom skill. Anthropic lists custom skill uploads on the Pro, Max, Ultra, Team and Enterprise plans with code execution enabled.

Connect the store

Create a WooCommerce REST API key, connect it in Ryze AI, then add https://connector.get-ryze.ai/mcp in Claude under Customize > Connectors. The WooCommerce MCP page covers the connection and the Ryze AI Claude guide covers each Claude app.

Anthropic advises using skills only from sources you trust, so read each file before you save it. A skill is plain text: it can tell Claude to call a write or delete tool, which is why the two write skills below ask for your confirmation first.

Order and revenue skills

These four read orders, refunds and sales reports. Order statuses are the WooCommerce ones: pending, processing, on-hold, completed, cancelled, refunded and failed (orders endpoint).

01. Weekly store recap

Compares the last 7 complete days with the 7 before. Revenue counts completed and processing orders, minus refunds, which is how Ryze AI reports WooCommerce revenue.

SKILL.md
--- name: woo-weekly-recap description: Weekly WooCommerce recap, last 7 days against the 7 days before. Use for weekly sales, order count or revenue summaries. --- # Woo weekly recap Read (GET): - orders with status processing and completed, after and before set to each 7-day window, paged until the end - reports/sales with date_min and date_max for each window - refunds for the same windows Steps: 1. Revenue = order totals minus refunds, per window. 2. Report order count, average order value and total_refunds for both windows with the percent change. 3. Name the 3 days with the highest revenue. Output: 5 short sentences and one table. Use returned numbers only. Change nothing.

Use it when: you send a Monday update.

02. Top sellers

Ranks products by units sold with the top sellers report, then adds revenue from order line items. The report takes a period of week, month, last_month or year, or a date_min and date_max.

SKILL.md
--- name: woo-top-sellers description: Ranks WooCommerce products by units and revenue for a period. Use when asked what sells best or which products to promote. --- # Woo top sellers Ask for the period (default last_month). Read (GET): - reports/top_sellers for the period - products for the returned product IDs: name, price, stock_status - orders for the period, to sum line item totals per product Steps: 1. Rank by quantity, then by revenue. 2. Flag a top seller whose stock_status is not instock. Output: a top 10 table with units, revenue and stock status. Change nothing.

Use it when: you plan a promotion or reorder.

03. Refund review

Lists refunds and the orders they belong to, so you can see which products and payment methods draw them.

SKILL.md
--- name: woo-refund-review description: Reviews WooCommerce refunds for a period and the orders behind them. Use when refunds rise or when asked why customers return items. --- # Woo refund review Read (GET): - refunds for the period - orders for each refunded order ID: line items, payment_method, customer_note Steps: 1. Group refunds by product and by payment_method. 2. Compare the refund total with the revenue of the same period. 3. List the products refunded more than once. Output: two tables and 3 sentences, with the refund reason text exactly as stored. Change nothing.

Use it when: the refund line in the weekly recap grows.

04. Order queue

Finds orders waiting on someone: pending payment, on-hold and failed, oldest first.

SKILL.md
--- name: woo-order-queue description: Lists WooCommerce orders stuck in pending, on-hold or failed status. Use at the start of the day or when customers ask about an order. --- # Woo order queue Read (GET): orders, one request per status (pending, on-hold, failed), sorted by date ascending. Steps: 1. Show age in days, total, payment_method and customer_note. 2. Flag orders older than 3 days. Output: one table per status, oldest first. Suggest the next step per row. Change nothing.

Use it when: you start the day or answer a where-is-my-order message.

Catalog, coupon and customer skills

Skills 05 to 08 read products, coupons and orders. Skills 09 and 10 write, so they need a Read/Write key and stop for your confirmation.

05. Stock watch

Products carry a stock_status of instock, outofstock or onbackorder, and a stock_quantity when stock is managed. The skill reads both.

SKILL.md
--- name: woo-stock-watch description: Lists WooCommerce products that are out of stock, on backorder or low on stock. Use before a promotion or weekly. --- # Woo stock watch Read (GET): products and product variations, with stock_status, stock_quantity, manage_stock and backorders. Steps: 1. List outofstock and onbackorder items. 2. List managed items with stock_quantity at or below the threshold the user gives (default 5). 3. Mark items that also appear in the last 30 days of top sellers. Output: a restock list ordered by recent sales. Change nothing.

Use it when: before a sale or each Friday.

06. Catalog audit

Products can be draft, pending, private or publish, and of type simple, grouped, external or variable. The audit lists items that look unfinished.

SKILL.md
--- name: woo-catalog-audit description: Audits a WooCommerce catalog for drafts, private items and missing prices. Use when cleaning up the store or before a launch. --- # Woo catalog audit Read (GET): products with status any, including status, type, regular_price, sale_price, sku and stock_status. Steps: 1. List products in draft, pending or private status. 2. List published products with an empty regular_price or no sku. 3. List sale prices set without an end date (date_on_sale_to). Output: a fix list grouped by problem, with product ID and name. Change nothing.

Use it when: you take over a store or prepare a launch.

07. Coupon audit

Coupons expose usage_count, usage_limit, usage_limit_per_user and date_expires_gmt. The coupons totals report adds a count by coupon type.

SKILL.md
--- name: woo-coupon-audit description: Audits WooCommerce coupons for usage, limits and expiry. Use when asked which coupons work or which to retire. --- # Woo coupon audit Read (GET): coupons (code, discount_type, amount, usage_count, usage_limit, date_expires_gmt) and reports/coupons/totals. Steps: 1. List expired coupons and coupons with no expiry and no usage limit. 2. Rank active coupons by usage_count. 3. Flag coupons at or near their usage_limit. Output: three short lists. Change nothing.

Use it when: a code leaks or after a campaign ends.

08. Customer orders

Splits buyers into first-time and repeat from the order list, by the customer ID on each order.

SKILL.md
--- name: woo-customer-orders description: Splits WooCommerce buyers into first-time and repeat for a period. Use when asked about repeat purchase or top customers. --- # Woo customer orders Read (GET): orders for the period with status processing and completed; customers for the IDs found. Steps: 1. Group orders by customer ID. Guest orders (customer ID 0) are reported as one separate line. 2. Count customers with 2 or more orders in the period. 3. List the 10 customers with the highest order total. Output: one summary table and the top 10. Show first names and order counts only. Change nothing.

Use it when: you review loyalty or plan a win-back offer.

09. Price and stock update

Changes regular_price, sale_price or stock for the products you list. It needs a Read/Write key and stops for confirmation.

SKILL.md
--- name: woo-price-stock-update description: Updates WooCommerce product prices or stock after the user confirms the exact list. Use when asked to change prices, start a sale or fix stock. --- # Woo price and stock update Read first (GET): products for the IDs or SKUs given. Show current regular_price, sale_price and stock_quantity. Steps: 1. Build a before and after table of every change. 2. Ask the user to reply yes to apply it. Stop if the answer is anything else. 3. Apply with the write tool (PUT products/<id>), one product at a time. 4. Read each product back and report the saved values. Never change a product that is not in the confirmed table.

Use it when: you start or end a sale. In Claude, set the write tool to Needs approval for a second check.

10. Coupon launch and cleanup

Creates a coupon from fields you give, and deletes coupons you name. Coupons accept a discount_type, an amount, a minimum_amount, a usage_limit and an expiry.

SKILL.md
--- name: woo-coupon-launch description: Creates a WooCommerce coupon or deletes expired ones after the user confirms. Use when asked to launch a code or clean up old codes. --- # Woo coupon launch and cleanup Create: ask for code, discount_type (percent, fixed_cart or fixed_product), amount, minimum_amount, usage_limit and expiry date. Show the full coupon and wait for a yes. Then write POST coupons and read it back. Cleanup: read coupons, list those with date_expires_gmt in the past, wait for a yes on the exact IDs, then delete those IDs with the delete tool. Never delete a coupon that is not on the confirmed list.

Use it when: a campaign starts or ends. Combine with the coupon audit (07) to choose what to retire.

Quick WooCommerce prompts: no skill file needed

For a one-time question, a plain prompt is enough once Claude can reach the store. Replace the words in brackets.

Prompt
Which 5 products had the most units sold in [PERIOD], and which of them are low on stock?
Prompt
List every order in on-hold or pending status older than 3 days, with total and payment method.
Prompt
Which coupons were used most in the last 30 days, and which have expired but are still published?
Prompt
Show the refunds from [PERIOD] grouped by product.

If an answer looks off, ask Claude which REST path it called and with which parameters.

How to run the skills on a live WooCommerce store

A skill only describes the task; Claude needs a connection to run it. The Ryze AI connector gives Claude 3 WooCommerce tools. They are generic REST tools, so each skill above names a path for them to call:

  1. woocommerce__read

    What it does
    GET requests: orders and refunds, sales reports, products and variations, customers, coupons, shipping and tax settings
    Used by
    Skills 01 to 10
  2. woocommerce__write

    What it does
    POST or PUT: coupons, products, order notes, order status, prices and stock; needs a Read/Write key
    Used by
    Skills 09 and 10
  3. woocommerce__delete

    What it does
    Deletes an object by path, such as a coupon or product
    Used by
    Skill 10

Connecting takes a REST API key from WooCommerce > Settings > Advanced > REST API > Add key, plus the store URL. Choose Read for reporting only, or Read/Write for changes. The store must be served over HTTPS, and a read-only key makes Ryze AI reject writes and deletes. Ryze AI holds one WooCommerce connection per workspace (Ryze AI WooCommerce guide).

Ryze AI does not publish blog posts to WooCommerce, so these skills cover store data only. Adding the connector is free; the tools need an active plan or trial, from Paid Ads at $89 a month with a 7-day free trial (see pricing).

Approvals

In the Ryze AI chat, the Tool approvals setting starts on Skip all approvals. Switch it to Approve write & delete or Manual approve to review changes. Scheduled tasks run without an approval step, so keep write skills out of schedules. In Claude, set the write and delete tools to Needs approval under Customize > Connectors > Ryze AI > Tool permissions.

REST API limits that shape the skills

  1. Lists return 10 items by default

    What it means for a skill
    Skills that total revenue must page through results with per_page and page; totals are in the X-WP-Total and X-WP-TotalPages headers
  2. Sales report periods

    What it means for a skill
    reports/sales takes week, month, last_month or year, or a date_min and date_max in YYYY-MM-DD
  3. Order status filter

    What it means for a skill
    The orders list filters by status, customer and product, and by date with after and before
  4. Pretty permalinks

    What it means for a skill
    The REST API needs permalinks other than the default; default permalinks do not work

Troubleshooting: when a WooCommerce skill returns a wrong answer

Claude has no WooCommerce tools

Claude keeps the tool list from when you added the connector. Remove and re-add it, then start a new chat (Ryze AI connector FAQ).

A write or delete is rejected

The REST API key is Read only. Create a Read/Write key in WooCommerce and reconnect.

The store will not connect

Ryze AI needs the store served over HTTPS and the store URL entered with https.

Totals look low

The list was cut at 10 items. Ask Claude to page through every result before it sums.

Revenue differs from WooCommerce Analytics

The skills count completed and processing orders minus refunds. Other tools can use other statuses or dates, so name the definition you want.

A different store is needed

Ryze AI holds one WooCommerce store per workspace. Disconnect the current store and connect the other.

Sources

The verdict

Turn each recurring store question into a skill with fixed paths and a fixed output. Start with the weekly recap and the stock watch, keep the two write skills behind a confirmation, and leave one-off questions as prompts.

Ryze AI runs these skills in Claude on a live WooCommerce store with a Read or Read/Write key. It holds one store per workspace, and it does not publish content to WooCommerce.

Frequently asked questions

What are Claude skills for WooCommerce?
SKILL.md files that tell Claude which WooCommerce REST API paths to call, which fields to use and how to present the result. Claude loads one when a request matches its description, so each check runs the same way every time.
Do I need a store connection to use these skills?
No. Each read skill also works on an order or product export you attach, if it has the fields the skill names. A connection removes the export step and lets Claude run the same skill whenever you ask.
Which Claude plan do I need?
Anthropic lists custom skill uploads on claude.ai for Pro, Max, Ultra, Team and Enterprise with code execution enabled. In Claude Code, skills are folders on your computer. For the connector, Anthropic lists custom connectors on Free, Pro, Max, Ultra, Team and Enterprise, with Free limited to one.
Can these skills change my store?
Skills 09 and 10 can, if the WooCommerce key has Read/Write permission. They stop for your confirmation first. With a Read key, Ryze AI rejects every write and delete.
Show 7 more questions
How do I make Claude ask before it changes anything?
In Claude, set the write and delete tools to Needs approval under Customize > Connectors > Ryze AI > Tool permissions. In the Ryze AI chat, switch Tool approvals from Skip all approvals to Approve write & delete or Manual approve.
Which WooCommerce key permission do I need?
Read is enough for skills 01 to 08. Skills 09 and 10 need Read/Write. Create the key at WooCommerce > Settings > Advanced > REST API > Add key.
Can I use this with more than one store?
Ryze AI holds one WooCommerce connection per workspace. To switch stores, disconnect the current one and connect the other.
What is the best Claude connector for WooCommerce?
For running these skills on live store data, use Ryze AI: one connector URL gives Claude read, write and delete tools for WooCommerce. Changes work only with a Read/Write key, and the store must use HTTPS.
Can these skills run on a schedule?
Read skills can run as Ryze AI scheduled tasks. Scheduled tasks run without an approval step, so schedule only the read-only skills.
Why do the skill names start with woo?
Anthropic reserves the words claude and anthropic in skill names, and allows only lowercase letters, numbers and hyphens, up to 64 characters. A woo prefix keeps the names valid and groups them.
Does Ryze AI publish blog posts to WooCommerce?
No. WooCommerce in Ryze AI covers store data. To publish articles, connect WordPress.

Related guides

Ryze AI: WooCommerce skills on live data

7-day free trial, $89 a month flat

Start free trial