sadrmanesh/commerce-agent-skills

Skills and rules for AI coding agents that build e-commerce and marketplace products.
Documentation:
The skills follow the Agent Skills format: a folder, a SKILL.md file with name and description, and optional reference files and scripts. An agent that supports that format can load them. The format does not name an install path. Installation explains how to point your agent at these folders.
Version 0.3.0 adds store operations to the library. It keeps the twenty skills from 0.1.0 and 0.2.0 and adds Stripe payments, Iranian payment gateways such as Zarinpal, inventory across warehouses, returns and refunds, B2B pricing, catalog import and migration, storefront accessibility, storefront performance, and MCP store tooling. It also adds a stricter validator and an eval runner that scores answers against the fixtures.
## Features
Twenty-nine skills an agent can load when a task matches the skill description.
A matching plain-Markdown rule for each skill, for agents that keep short rules in context.
Evaluation tasks and a worked example for every skill, and scripts/run-evals.mjs to score answers against them.
Reference notes and small Node.js tools where a check is better than another paragraph.
A strict validator, a catalog built from the skill files, and a docs build, all run in CI. The validator checks versions, required sections, rule headings, that every eval term is taught by the skill, category coverage, and prose style.
An npx @sadrmanesh/commerce-agent-skills installer that copies every skill and rule, or the ones you name, into your project.
## Skill catalog
| Skill | Description |
| woocommerce-plugin-development | Build and change WooCommerce plugins with hooks, CRUD data stores, HPOS-safe order access, nonces, capabilities, and gettext. Use when writing or reviewing a plugin that reads or writes WooCommerce products, orders, customers, or checkout. |
| woocommerce-rest-api | Call the WooCommerce REST API at wc/v3, including authentication, pagination, batch writes, and webhook registration, and keep it separate from the Store API. Use when an external system integrates with a WooCommerce store over HTTP. |
| wordpress-plugin-security | Review and implement WordPress plugin security: capabilities, nonces, sanitization, escaping, prepared SQL, and REST permission callbacks. Use when adding admin screens, AJAX, uploads, hooks, or REST routes in a WordPress or WooCommerce plugin. |
| payment-gateway-integration | Integrate a payment provider with idempotent charges, signature-checked webhooks, and an explicit map from provider states to order states. Use when adding or changing checkout payment, capture, refund, or payment notification handling. |
| product-catalog-modeling | Model a sellable catalog of simple products, variants, attributes, SKUs, and stock, and check the model before importing it. Use when designing product data, variation matrices, inventory rules, or catalog imports. |
| marketplace-search-and-ranking | Index purchasable catalog units and rank them with text relevance, facets, stock, and language-aware matching for Persian and other languages. Use when building marketplace search, filters, relevance, or multilingual product discovery. |