Skip to content

commerce-agent-skills

Agent Skills and always-on rules that help AI coding agents build e-commerce and marketplace products correctly: WooCommerce, Shopify, Stripe and Iranian gateways, inventory, returns, B2B pricing, search, feeds, accessibility, performance, MCP store tools, and RTL storefronts.

29 skills in 5 categories, each with a matching rule, reference notes, evaluation fixtures, and small Node.js checks where a check beats another paragraph. Every skill follows the open Agent Skills format, so any agent that supports that format can load it.

Get started Browse the skills Hugging Face dataset GitHub

npx @sadrmanesh/commerce-agent-skills init
npx @sadrmanesh/commerce-agent-skills add woocommerce-plugin-development stripe-payments

Why

Commerce code fails in expensive ways: a webhook processed twice, a price in structured data that does not match the page, an order read through post meta after HPOS, a vendor paid before the money settled. General-purpose agents know the APIs but not these contracts.

  • Procedures, not essays. Each skill is a short, ordered procedure with the exact API names, headers, and states that matter.
  • Constraints that stay in context. Every skill has a plain Markdown rule for agents that keep short guidance loaded on every task.
  • Checks you can run. Evaluation fixtures state what a correct answer must and must not contain. The validator runs them in CI, and the eval runner scores your own agent's answers against them.
  • Tool-agnostic. Plain folders and Markdown. No vendor lock-in. One npx command copies the folders, or copy them by hand.

Skill catalog

  • Platforms and storefronts

    WooCommerce, WordPress, Shopify, and headless Next.js storefronts.

    5 skills: woocommerce-plugin-development, woocommerce-rest-api, wordpress-plugin-security, shopify-app-development, headless-nextjs-storefront

    Browse

  • Payments and orders

    Stripe, Iranian gateways, webhooks, subscriptions, risk, tax, shipping, and vendor payouts.

    8 skills: payment-gateway-integration, order-and-webhook-reliability, subscription-billing, fraud-and-risk-basics, tax-and-shipping, multi-vendor-payouts, stripe-payments, iranian-payment-gateways

    Browse

  • Catalog and search

    Catalog modeling, marketplace ranking, vector search, feeds, and grounded product copy.

    5 skills: product-catalog-modeling, marketplace-search-and-ranking, vector-product-search, google-merchant-product-feeds, product-description-guardrails

    Browse

  • Conversion and growth

    Checkout UX, accessibility, Core Web Vitals, structured data, analytics events, and Persian RTL localization.

    6 skills: checkout-ux-and-conversion, ecommerce-seo-structured-data, conversion-event-tracking, rtl-and-persian-localization, storefront-accessibility, storefront-performance

    Browse

  • Store operations

    Inventory across warehouses, returns and refunds, B2B pricing, catalog migrations, and MCP store tools.

    5 skills: inventory-and-multi-warehouse, returns-and-refunds, b2b-pricing, catalog-import-and-migration, mcp-store-tooling

    Browse

What is in a skill

  • SKILL.md

    Name, description with a clear "Use when", and the procedure an agent follows.

    Skill format

  • Matching rule

    Eight to eighty lines of always-on constraints for the same area.

    Rules

  • Evaluation fixtures

    Tasks with must_include and must_not_include checks, a worked example, and a runner that scores answers.

    Evaluation fixtures

  • Command line

    A zero-dependency command that lists skills and copies one into your project.

    Command line

License

MIT. Copyright (c) 2026 Naser Sadrmanesh.