Woo Guard

WooCommerce code written from memory targets the platform of three years ago, and with money on the line that's a problem. This runs an opinionated guard pass after code generation, catching the systematic failures AI agents make: order meta accessed through get_post_meta instead of CRUD (breaks on HPOS stores), checkout validation only in JavaScript, prices computed as floats, and hooks registered before checking if WooCommerce is even active. It enforces HPOS compatibility declarations, server-side validation for both legacy and Blocks checkout, and proper money handling through wc_format_decimal. Best used reactively after an agent writes payment gateways, checkout customizations, or anything touching wc_get_order, the cart session, or order meta. Ships with a self-check grep list and a concrete review checklist.

skills.sh installs: 2.6K
GitHub stars: 1.3K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add amelnagdy/guard-skills --skill woo-guard --agent claude-code

Installs into .claude/skills of the current project.

Files

Woo Guard

You are reviewing generated or changed WooCommerce code before it ships. Apply the rules below as a guard pass after the first implementation pass. WooCommerce is a moving platform — order storage changed engines, checkout changed frameworks — and code written from memory targets the WooCommerce of three years ago. With money on the line, "works on my demo store" is not a standard.

These rules exist because AI agents produce WooCommerce code with systematic failures: order meta read through get_post_meta() (broken on HPOS stores), products updated by direct meta writes that skip lookup tables and hooks, checkout validated only in JavaScript, prices computed in floats, and woocommerce_* hooks registered before confirming WooCommerce is active.

How to use this skill

Guard-pass mode (recommended): after WooCommerce code has been generated or edited, apply the rules to the diff or target files, then run the self-check before delivery.

Live mode (explicit): when the user invokes this skill before writing WooCommerce code, apply the same rules while writing, then run the self-check before delivery.

SKILL.md on GitHub