A free Claude Skill that teaches Claude the safe, composable patterns for running a WooCommerce store via AI: bulk price and stock updates, product creation with variations, order status transitions with customer-notification control, coupon lifecycle (create, bulk generate, expire, delete with two-step confirm), grouped-product child management, and WooCommerce Subscriptions pause / resume / cancel. Every write emits a 72-hour undo token. Bulk deletes above 10 items require a two-step confirm. Works with WooCommerce plus the free Royal MCP plugin from WordPress.org or Royal MCP Pro. Copy the instructions or download the file, drop it into Claude Desktop or Claude in browser, and your next store operation runs cleanly on the first try.
Then in Claude: Settings → Skills → Add → Write skill instructions (paste) or Upload a skill (drop the file).
This skill teaches Claude how to run WooCommerce store operations intelligently: update prices in bulk with per-row verification, create products with variations (custom or global attributes, always-draft-first), transition order statuses with customer-notification discipline, run coupon lifecycles with two-step confirm above 10 items, and gate destructive bulk operations behind SiteVault handoffs. Without both Royal MCP and WooCommerce installed on your WordPress site, Claude will know the workflows but can't execute them. Both are free from WordPress.org (WooCommerce is 100% free; Royal MCP Free covers 32 WooCommerce tools). Royal MCP Pro adds 17 more tools for bulk operations, subscription lifecycle, and grouped-product management — recommended for agencies or operators running weekly bulk campaigns, optional for single-store operators.
Once Royal MCP is active on your WordPress site (see above), loading the skill takes about two minutes. Exactly the flow Anthropic ships their own skills through — same Add menu, same paste-or-upload options.
Click Copy skill instructions or Download WooCommerce Claude Skill at the top of this page. That's the whole file: no zip, no repo, no dependencies.
In Claude Desktop or Claude in your browser, open Settings → Skills. Click the Add button at the top-right.
Choose Write skill instructions and paste the copied content, or Upload a skill and drop the .md file. Save. Claude will auto-load it whenever you ask about updating prices, creating products, running coupons, or transitioning orders.
The skill teaches Claude one thing: every write is verifiable, every destructive bulk op counts what it's about to touch BEFORE firing, and every claim about "your store is updated" is grounded in a real post-write spot-check. Every workflow checks WooCommerce is active first, reports counts and skips verbatim (never rounds up), and quotes the 72-hour undo token so operators always have a rollback lane.
Scope the target set, warn on variable-product parents (silent no-op class), dry-run first to surface skip reasons (insufficient_caps, no_price_fields, not_found), fire the real batch, then spot-check ONE product via wc_get_product to catch silent middleware absorption. Reports the count + sample verification + undo token.
Create the parent as type: variable, status: draft (never set regular_price on the parent), assign attributes with variation: true, batch-create all variations in one wc_batch_update_variations call. Pauses for operator eyeball before publishing. Handles the clone-existing pattern by deriving attribute structure from the source's variations.
Single-order path warns operators BEFORE firing that customer emails will fire (no suppression on Free). Bulk path (Pro) defaults suppress_notifications: TRUE to avoid firing 500 emails during a batch. Undo scope precisely documented: reverses the status column but fires reverse-direction emails, stock adjustments, and integration hooks.
Single and bulk create / update / expire / delete flows. Coupon codes always lowercased at storage. force_delete_used: true requires explicit ack of the audit-trail cost. wc_bulk_delete_coupons above 10 items requires a two-step confirm (preview + token echo). Full state-drift guardrail on undo for the Free single-coupon path.
Meta-workflow that gates every destructive bulk write. Count-first pattern (never fire "delete all X" without a concrete number), SiteVault handoff thresholds (N > 50 permanent delete, N > 100 any destructive, any subscription-touching op), dry-run discipline, two-step confirm mechanics, force-flag / bypass-guard reporting, snapshot-cap awareness, verbatim skip / error reporting.
Exactly what gets pasted into Claude when you click Copy above — nothing hidden, nothing bundled. Scroll to read; or just copy and paste it into Claude to try.
woocommerce-mcp.md
Loading skill content…
wc_update_order_status) DOES fire whatever customer-facing emails WooCommerce has enabled for that transition — no suppression option exists on Free. The skill teaches Claude to WARN before firing every single-order status change so operators aren't surprised. The Pro bulk tool (wc_bulk_update_orders) defaults to suppress_notifications: TRUE — the bulk path is intentionally quiet to avoid firing 500 emails in a row during a batch. Operators must explicitly opt in to notifications on bulk ops. The skill documents both behaviors and enforces the warning discipline in Workflow 3.confirm_token, the second call must echo the token to actually fire. Second, the skill's Pre-flight Safety workflow (Workflow 5) requires an exact count resolution BEFORE any destructive call — operators authorize a number, not a descriptor. Third, cross-skill handoff to SiteVault: bulk operations above 50 items on permanent-delete paths, or above 100 items on any destructive path, or any subscription-touching operation, get routed to the SiteVault Claude Skill Workflow 1 for a fresh backup before the write. Plus every write emits a 72-hour undo token.wc_bulk_price_update accepts literal price strings only — no operation param, no percentage math built in. The skill teaches Claude to fetch each product's current regular_price via wc_get_product, apply the requested percentage caller-side, and pass the FINAL string values to the tool. This means the operator sees exactly which products will change and to what price BEFORE the write fires. Variable-product parents are handled with a proactive warning — the tool silently no-ops on variable parents because WooCommerce reads variation prices for display, so the skill routes variations through wc_batch_update_variations instead.wc_bulk_price_update can be looped on Free by calling wc_update_product one-at-a-time. The skill's Pro upgrade paths section has a decision table for when to offer the Free loop vs recommend Pro (rule of thumb: <10 items loop Free; 10–50 present both; 50+ recommend Pro).mcp_undo_last_operation reverses the DATABASE state — the coupon that was created gets deleted, the product field that was changed gets restored, the order status walks back. What undo does NOT reverse: customer emails that already fired, integration webhooks that already ran, stock adjustments already logged, refunds initiated by payment gateways. The skill documents this precisely in Workflow 3's undo scope section — reversing an order status transition actually FIRES the reverse-direction transition, so customers can end up with two emails and integrations fire in both directions. Bulk operations get a single batch undo token that reverses every touched row in one call.wcs_* tools (list, pause, resume, cancel, update next payment date) are exposed, plus WCS-aware discount types on the Pro bulk coupon tools. The skill has full workflows for WCS pause / resume / cancel with two-step confirm on cancel. WooCommerce Bookings and Memberships don't currently have Royal MCP integrations, so their APIs aren't exposed via MCP tools — the skill only covers WooCommerce core plus Subscriptions.