@sadrmanesh/commerce-agent-skills 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [0.3.1] - 2026-10-30
+
+### Added
+
+- The release workflow publishes `@sadrmanesh/commerce-agent-skills` to GitHub Packages after npm, using the workflow's `GITHUB_TOKEN`. npmjs.com remains the main registry.
+- Install docs for GitHub Packages, with the `.npmrc` scope entry, in the installation guide and the README.
+
+### Changed
+
+- The package and every skill are now version 0.3.1.
+
 ## [0.3.0] - 2026-10-30
 
 ### Added

package/README.md

@@ -72,6 +72,8 @@ npx @sadrmanesh/commerce-agent-skills init --skills-dir path/to/skills --rules-d
 
 `init` skips skills that are already installed, `--force` replaces them, and `--dry-run` shows what would be written. From a checkout, `node bin/commerce-agent-skills.mjs` takes the same arguments. Details are in [docs/installation.md](docs/installation.md) and [docs/cli.md](docs/cli.md).
 
+The package is on npmjs.com and, with the same name, on GitHub Packages. npmjs.com is the default; [docs/installation.md](docs/installation.md#install-from-github-packages) has the `.npmrc` lines for GitHub Packages.
+
 ## Work on the library
 
 Clone the repository and check the skills:
@@ -113,7 +115,7 @@ The skill format is documented in [docs/skill-format.md](docs/skill-format.md).
 
 The documentation lives at [sadrmanesh.github.io/commerce-agent-skills](https://sadrmanesh.github.io/commerce-agent-skills/). It is built with MkDocs Material, and the skill, rule, and guide pages are generated from this repository by `scripts/build-docs.mjs`, so they always match the files here. `.github/workflows/pages.yml` deploys it on pushes to `main`. See [docs/github-pages.md](docs/github-pages.md).
 
-`.github/workflows/release.yml` runs when a `vX.Y.Z` tag is pushed. It checks that the tag matches `package.json`, runs the validator, evals, and tests, creates the GitHub release if it does not exist, and publishes `@sadrmanesh/commerce-agent-skills` to npm. Running it by hand with a version tags that version first.
+`.github/workflows/release.yml` runs when a `vX.Y.Z` tag is pushed. It checks that the tag matches `package.json`, runs the validator, evals, and tests, creates the GitHub release if it does not exist, and publishes `@sadrmanesh/commerce-agent-skills` to npm and to GitHub Packages, which uses the workflow's `GITHUB_TOKEN`. Running it by hand with a version tags that version first.
 
 ## Roadmap
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sadrmanesh/commerce-agent-skills",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Tool-agnostic skills and rules for AI coding agents that build e-commerce and marketplace products.",
   "keywords": [
     "agent-skills",

package/skills/b2b-pricing/SKILL.md

@@ -5,7 +5,7 @@ license: MIT
 compatibility: "The price resolver needs Node.js 20 or newer and no packages."
 metadata:
   author: Naser Sadrmanesh
-  version: "0.3.0"
+  version: "0.3.1"
 ---
 
 # B2B pricing

package/skills/catalog-import-and-migration/SKILL.md

@@ -5,7 +5,7 @@ license: MIT
 compatibility: "The row checker needs Node.js 20 or newer and no packages."
 metadata:
   author: Naser Sadrmanesh
-  version: "0.3.0"
+  version: "0.3.1"
 ---
 
 # Catalog import and migration

package/skills/checkout-ux-and-conversion/SKILL.md

@@ -4,7 +4,7 @@ description: "Design checkout so the full cost is visible before payment, guest
 license: MIT
 metadata:
   author: Naser Sadrmanesh
-  version: "0.3.0"
+  version: "0.3.1"
 ---
 
 # Checkout UX and conversion

package/skills/conversion-event-tracking/SKILL.md

@@ -5,7 +5,7 @@ license: MIT
 compatibility: "The event checker requires Node.js 20 or newer. No network access."
 metadata:
   author: Naser Sadrmanesh
-  version: "0.3.0"
+  version: "0.3.1"
 ---
 
 # Conversion event tracking

package/skills/ecommerce-seo-structured-data/SKILL.md

@@ -5,7 +5,7 @@ license: MIT
 compatibility: "The JSON-LD checker requires Node.js 20 or newer. No network access."
 metadata:
   author: Naser Sadrmanesh
-  version: "0.3.0"
+  version: "0.3.1"
 ---
 
 # Ecommerce SEO structured data

package/skills/fraud-and-risk-basics/SKILL.md

@@ -4,7 +4,7 @@ description: "Hold or review risky payments using provider signals, velocity, an
 license: MIT
 metadata:
   author: Naser Sadrmanesh
-  version: "0.3.0"
+  version: "0.3.1"
 ---
 
 # Fraud and risk basics

package/skills/google-merchant-product-feeds/SKILL.md

@@ -5,7 +5,7 @@ license: MIT
 compatibility: "The feed item checker requires Node.js 20 or newer. No network access."
 metadata:
   author: Naser Sadrmanesh
-  version: "0.3.0"
+  version: "0.3.1"
 ---
 
 # Google Merchant product feeds

package/skills/headless-nextjs-storefront/SKILL.md

@@ -4,7 +4,7 @@ description: "Build a Next.js storefront that loads catalog data on the server,
 license: MIT
 metadata:
   author: Naser Sadrmanesh
-  version: "0.3.0"
+  version: "0.3.1"
 ---
 
 # Headless Next.js storefront

package/skills/inventory-and-multi-warehouse/SKILL.md

@@ -5,7 +5,7 @@ license: MIT
 compatibility: "The allocation checker needs Node.js 20 or newer and no packages."
 metadata:
   author: Naser Sadrmanesh
-  version: "0.3.0"
+  version: "0.3.1"
 ---
 
 # Inventory and multi-warehouse

package/skills/iranian-payment-gateways/SKILL.md

@@ -5,7 +5,7 @@ license: MIT
 compatibility: "The verify checker needs Node.js 20 or newer and no packages."
 metadata:
   author: Naser Sadrmanesh
-  version: "0.3.0"
+  version: "0.3.1"
 ---
 
 # Iranian payment gateways

package/skills/marketplace-search-and-ranking/SKILL.md

@@ -5,7 +5,7 @@ license: MIT
 compatibility: "The search-text normalizer requires Node.js 20 or newer. No network access."
 metadata:
   author: Naser Sadrmanesh
-  version: "0.3.0"
+  version: "0.3.1"
 ---
 
 # Marketplace search and ranking

package/skills/mcp-store-tooling/SKILL.md

@@ -5,7 +5,7 @@ license: MIT
 compatibility: "The tool definition checker needs Node.js 20 or newer and no packages."
 metadata:
   author: Naser Sadrmanesh
-  version: "0.3.0"
+  version: "0.3.1"
 ---
 
 # MCP store tooling

package/skills/multi-vendor-payouts/SKILL.md

@@ -4,7 +4,7 @@ description: "Split a marketplace order by vendor, record commission as ledger e
 license: MIT
 metadata:
   author: Naser Sadrmanesh
-  version: "0.3.0"
+  version: "0.3.1"
 ---
 
 # Multi-vendor payouts

package/skills/order-and-webhook-reliability/SKILL.md

@@ -5,7 +5,7 @@ license: MIT
 compatibility: "The signature checker requires Node.js 20 or newer. No network access."
 metadata:
   author: Naser Sadrmanesh
-  version: "0.3.0"
+  version: "0.3.1"
 ---
 
 # Order and webhook reliability

package/skills/payment-gateway-integration/SKILL.md

@@ -4,7 +4,7 @@ description: "Integrate a payment provider with idempotent charges, signature-ch
 license: MIT
 metadata:
   author: Naser Sadrmanesh
-  version: "0.3.0"
+  version: "0.3.1"
 ---
 
 # Payment gateway integration

package/skills/product-catalog-modeling/SKILL.md

@@ -5,7 +5,7 @@ license: MIT
 compatibility: "The catalog checker requires Node.js 20 or newer. No network access."
 metadata:
   author: Naser Sadrmanesh
-  version: "0.3.0"
+  version: "0.3.1"
 ---
 
 # Product catalog modeling

package/skills/product-description-guardrails/SKILL.md

@@ -5,7 +5,7 @@ license: MIT
 compatibility: "The description checker requires Node.js 20 or newer. No network access."
 metadata:
   author: Naser Sadrmanesh
-  version: "0.3.0"
+  version: "0.3.1"
 ---
 
 # Product description guardrails

package/skills/returns-and-refunds/SKILL.md

@@ -4,7 +4,7 @@ description: "Run returns as a tracked RMA from request to inspection, refund on
 license: MIT
 metadata:
   author: Naser Sadrmanesh
-  version: "0.3.0"
+  version: "0.3.1"
 ---
 
 # Returns and refunds

package/skills/rtl-and-persian-localization/SKILL.md

@@ -5,7 +5,7 @@ license: MIT
 compatibility: "The Persian normalizer requires Node.js 20 or newer. No network access."
 metadata:
   author: Naser Sadrmanesh
-  version: "0.3.0"
+  version: "0.3.1"
 ---
 
 # RTL and Persian localization

package/skills/shopify-app-development/SKILL.md

@@ -4,7 +4,7 @@ description: "Build a Shopify app with the configured Admin API version, session
 license: MIT
 metadata:
   author: Naser Sadrmanesh
-  version: "0.3.0"
+  version: "0.3.1"
 ---
 
 # Shopify app development

package/skills/storefront-accessibility/SKILL.md

@@ -4,7 +4,7 @@ description: "Build product, cart, and checkout pages that meet WCAG 2.2 AA: key
 license: MIT
 metadata:
   author: Naser Sadrmanesh
-  version: "0.3.0"
+  version: "0.3.1"
 ---
 
 # Storefront accessibility

package/skills/storefront-performance/SKILL.md

@@ -5,7 +5,7 @@ license: MIT
 compatibility: "The Web Vitals checker needs Node.js 20 or newer and no packages."
 metadata:
   author: Naser Sadrmanesh
-  version: "0.3.0"
+  version: "0.3.1"
 ---
 
 # Storefront performance

package/skills/stripe-payments/SKILL.md

@@ -5,7 +5,7 @@ license: MIT
 compatibility: "The signature checker needs Node.js 20 or newer and no packages."
 metadata:
   author: Naser Sadrmanesh
-  version: "0.3.0"
+  version: "0.3.1"
 ---
 
 # Stripe payments

package/skills/subscription-billing/SKILL.md

@@ -4,7 +4,7 @@ description: "Model subscription state, renewal charges, proration, and dunning
 license: MIT
 metadata:
   author: Naser Sadrmanesh
-  version: "0.3.0"
+  version: "0.3.1"
 ---
 
 # Subscription billing

package/skills/tax-and-shipping/SKILL.md

@@ -4,7 +4,7 @@ description: "Calculate tax and shipping from the destination and the store's co
 license: MIT
 metadata:
   author: Naser Sadrmanesh
-  version: "0.3.0"
+  version: "0.3.1"
 ---
 
 # Tax and shipping

package/skills/vector-product-search/SKILL.md

@@ -4,7 +4,7 @@ description: "Add vector retrieval beside lexical product search, with one embed
 license: MIT
 metadata:
   author: Naser Sadrmanesh
-  version: "0.3.0"
+  version: "0.3.1"
 ---
 
 # Vector product search

package/skills/woocommerce-plugin-development/SKILL.md

@@ -4,7 +4,7 @@ description: "Build and change WooCommerce plugins with hooks, CRUD data stores,
 license: MIT
 metadata:
   author: Naser Sadrmanesh
-  version: "0.3.0"
+  version: "0.3.1"
 ---
 
 # WooCommerce plugin development

package/skills/woocommerce-rest-api/SKILL.md

@@ -4,7 +4,7 @@ description: "Call the WooCommerce REST API at wc/v3, including authentication,
 license: MIT
 metadata:
   author: Naser Sadrmanesh
-  version: "0.3.0"
+  version: "0.3.1"
 ---
 
 # WooCommerce REST API

package/skills/wordpress-plugin-security/SKILL.md

@@ -4,7 +4,7 @@ description: "Review and implement WordPress plugin security: capabilities, nonc
 license: MIT
 metadata:
   author: Naser Sadrmanesh
-  version: "0.3.0"
+  version: "0.3.1"
 ---
 
 # WordPress plugin security