Teach AI coding assistants how to build WooCommerce extensions the right way.

Agent Skills are portable bundles of instructions, checklists, and scripts that help AI assistants (Claude, Copilot, Codex, Cursor, etc.) understand WooCommerce development patterns, avoid common mistakes, and follow best practices.

AI coding assistants are powerful, but they often:

• Generate outdated WooCommerce patterns (pre-HPOS, deprecated hooks)
• Miss critical security considerations in payment gateway development
• Skip proper HPOS compatibility declarations
• Ignore existing tooling in your repo

Agent Skills solve this by giving AI assistants expert-level WooCommerce knowledge in a format they can actually use.

# Clone agent-skills
git clone https://github.com/WordPress/agent-skills.git
cd agent-skills

# Build the distribution
node shared/scripts/skillpack-build.mjs --clean

# Install all skills globally (available across all projects)
node shared/scripts/skillpack-install.mjs --global

# Or install specific skills only
node shared/scripts/skillpack-install.mjs --global --skills=woo-cart-checkout

This installs skills to ~/.claude/skills/ where Claude Code will automatically discover them.

# Clone agent-skills
git clone https://github.com/WordPress/agent-skills.git
cd agent-skills

# Build the distribution
node shared/scripts/skillpack-build.mjs --clean

# Install into your WooCommerce project
node shared/scripts/skillpack-install.mjs --dest=../your-woo-project --targets=codex,vscode,claude

This copies skills into:

• .codex/skills/ for OpenAI Codex
• .github/skills/ for VS Code / GitHub Copilot
• .claude/skills/ for Claude Code (project-level)

# List available skills
node shared/scripts/skillpack-install.mjs --list

# Dry run (preview without installing)
node shared/scripts/skillpack-install.mjs --global --dry-run

# Install specific skills to a project
node shared/scripts/skillpack-install.mjs --dest=../my-repo --targets=claude --skills=woo-cart-checkout

Copy any skill folder from skills/ into your project's instructions directory for your AI assistant.

Each skill contains:

skills/woo-cart-checkout/
├── SKILL.md              # Main instructions (when to use, procedure, verification)
├── references/           # Deep-dive docs on specific topics
│   └── ...
└── scripts/              # Deterministic helpers (detection, validation)
    └── ...

When you ask your AI assistant to work on WooCommerce code, it reads these skills and follows the documented procedures rather than guessing.

• WooCommerce 10.x+ (WordPress 6.7+, PHP 8.0+)
• Works with any AI assistant that supports project-level instructions

We welcome contributions! This project is a great way to share your WooCommerce expertise—you don't need to be a coding wizard. Most skills are written in Markdown, focusing on clear procedures and best practices.

See CONTRIBUTING.md for details on how to get started.

Quick commands:

# Scaffold a new skill
node shared/scripts/scaffold-skill.mjs <skill-name> "<description>"

# Validate skills
node eval/harness/run.mjs

• Authoring Guide - How to create and improve skills
• Principles - Design philosophy
• Packaging - Build and distribution
• Compatibility Policy - Version targeting

GPL-2.0-or-later