From b4d6a6f4a0dce561f46a1b0601b4f05d439bcc60 Mon Sep 17 00:00:00 2001 From: Charles Lavery Date: Wed, 22 Apr 2026 13:34:02 -0400 Subject: [PATCH 1/7] Add Codex plugin installation instructions to Agent Skills --- README.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/README.md b/README.md index 8856e5e..5b3f40c 100644 --- a/README.md +++ b/README.md @@ -208,6 +208,14 @@ copilot plugin marketplace add SalesforceCommerceCloud/commerce-apps copilot plugin install cap-dev@commerce-apps ``` +#### Codex + +```bash +codex plugin marketplace add SalesforceCommerceCloud/commerce-apps +``` + +Then in Codex, run `/plugins`, select the "Commerce Apps" marketplace, and install the `cap-dev` plugin. + #### Manual Installation For IDEs without marketplace support, copy the skills directory: From f31786fc5ec4d98899e72fddcad61e7f71237ef7 Mon Sep 17 00:00:00 2001 From: Charles Lavery Date: Wed, 22 Apr 2026 14:26:20 -0400 Subject: [PATCH 2/7] codex marketplace basics --- .agents/plugins/marketplace.json | 20 +++++++++++++++++ .claude/.codex-plugin/plugin.json | 37 +++++++++++++++++++++++++++++++ .gitignore | 4 +++- 3 files changed, 60 insertions(+), 1 deletion(-) create mode 100644 .agents/plugins/marketplace.json create mode 100644 .claude/.codex-plugin/plugin.json diff --git a/.agents/plugins/marketplace.json b/.agents/plugins/marketplace.json new file mode 100644 index 0000000..e595cd7 --- /dev/null +++ b/.agents/plugins/marketplace.json @@ -0,0 +1,20 @@ +{ + "name": "commerce-apps", + "interface": { + "displayName": "Commerce App Development" + }, + "plugins": [ + { + "name": "cap-dev", + "source": { + "source": "local", + "path": "./.claude" + }, + "policy": { + "installation": "AVAILABLE", + "authentication": "ON_INSTALL" + }, + "category": "Productivity" + } + ] +} diff --git a/.claude/.codex-plugin/plugin.json b/.claude/.codex-plugin/plugin.json new file mode 100644 index 0000000..38baf13 --- /dev/null +++ b/.claude/.codex-plugin/plugin.json @@ -0,0 +1,37 @@ +{ + "name": "cap-dev", + "version": "0.0.1", + "description": "Skills for scaffolding, packaging, validating, and submitting Commerce App Packages (CAPs) for Salesforce Commerce Cloud.", + "author": { + "name": "Salesforce" + }, + "homepage": "https://github.com/SalesforceCommerceCloud/commerce-apps", + "repository": "https://github.com/SalesforceCommerceCloud/commerce-apps", + "license": "Apache-2.0", + "keywords": [ + "salesforce", + "commerce-cloud", + "commerce-apps", + "cap", + "storefront-next" + ], + "skills": "./skills/", + "interface": { + "displayName": "Commerce App Development", + "shortDescription": "Build, validate, and submit Commerce App Packages for Salesforce Commerce Cloud.", + "longDescription": "Skills for the full Commerce App Package (CAP) development lifecycle — scaffold new apps, generate impex configurations, package into registry-ready ZIPs, validate structure and manifests, and submit pull requests.", + "developerName": "Salesforce", + "category": "Productivity", + "capabilities": [ + "Read" + ], + "brandColor": "#0D9DDA", + "websiteURL": "https://github.com/SalesforceCommerceCloud/commerce-apps", + "defaultPrompt": [ + "Scaffold a new tax app", + "Generate service impex for a REST API integration", + "Package my app for submission", + "Validate my app before submitting" + ] + } +} diff --git a/.gitignore b/.gitignore index 8b6acfd..169fa58 100644 --- a/.gitignore +++ b/.gitignore @@ -61,11 +61,13 @@ $RECYCLE.BIN/ # Keep the .gitignore file itself! !.gitignore -# Keep Claude Code, Cursor, and plugin marketplace directories +# Keep Claude Code, Cursor, Codex, and plugin marketplace directories !.claude/ !.claude/** !.claude-plugin/ !.claude-plugin/** +!.agents/ +!.agents/** !.cursor/ !.cursor/** From 74d0c9b96fddac588142eb833779a9bf48ed2ba5 Mon Sep 17 00:00:00 2001 From: Charles Lavery Date: Wed, 22 Apr 2026 16:27:00 -0400 Subject: [PATCH 3/7] note for b2c dx --- README.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/README.md b/README.md index 5b3f40c..99baea8 100644 --- a/README.md +++ b/README.md @@ -178,6 +178,9 @@ Turn your coding agent into a Commerce Apps specialist. Skills give Claude Code, Skills follow the open [Agent Skills](https://agentskills.io/home) standard and work with [Claude Code](https://claude.ai/code), Cursor, GitHub Copilot, VS Code, Codex, and others. +> [!TIP] +> For B2C Commerce development and operations skills, also install the **B2C Developer Tooling** plugins. See the [B2C DX documentation](https://salesforcecommercecloud.github.io/b2c-developer-tooling/) for installation instructions. + ### Quick Start Install via your IDE's plugin marketplace or manually copy skills into your IDE's skills directory. From 9514c0fcee39e5ea519e5d0dc6cdc635ccd8dc31 Mon Sep 17 00:00:00 2001 From: Charles Lavery Date: Wed, 22 Apr 2026 16:42:58 -0400 Subject: [PATCH 4/7] Add B2C CLI installation method to Agent Skills --- README.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/README.md b/README.md index 99baea8..a39c5ea 100644 --- a/README.md +++ b/README.md @@ -219,6 +219,24 @@ codex plugin marketplace add SalesforceCommerceCloud/commerce-apps Then in Codex, run `/plugins`, select the "Commerce Apps" marketplace, and install the `cap-dev` plugin. +#### B2C CLI + +The [B2C CLI](https://salesforcecommercecloud.github.io/b2c-developer-tooling/) can install skills to any supported IDE: + +```bash +# Interactive — choose IDE and skills +npx @salesforce/b2c-cli setup skills cap-dev + +# Non-interactive — install to a specific IDE +npx @salesforce/b2c-cli setup skills cap-dev --ide cursor + +# Install globally (user scope) +npx @salesforce/b2c-cli setup skills cap-dev --ide cursor --global + +# Install specific skills only +npx @salesforce/b2c-cli setup skills cap-dev --skill validate-app --skill package-app --ide cursor +``` + #### Manual Installation For IDEs without marketplace support, copy the skills directory: From 3cfb841a5c8d5ddbfa27d620914430d04a5a0898 Mon Sep 17 00:00:00 2001 From: Charles Lavery Date: Wed, 22 Apr 2026 16:45:58 -0400 Subject: [PATCH 5/7] Use interactive b2c setup skills example without skillset arg --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index a39c5ea..1bebd82 100644 --- a/README.md +++ b/README.md @@ -224,8 +224,8 @@ Then in Codex, run `/plugins`, select the "Commerce Apps" marketplace, and insta The [B2C CLI](https://salesforcecommercecloud.github.io/b2c-developer-tooling/) can install skills to any supported IDE: ```bash -# Interactive — choose IDE and skills -npx @salesforce/b2c-cli setup skills cap-dev +# Interactive — choose skillset, IDE, and skills +npx @salesforce/b2c-cli setup skills # Non-interactive — install to a specific IDE npx @salesforce/b2c-cli setup skills cap-dev --ide cursor From c765daa41897f91b455d1c49faccdc14d1178c7c Mon Sep 17 00:00:00 2001 From: Charles Lavery Date: Wed, 22 Apr 2026 16:46:12 -0400 Subject: [PATCH 6/7] Remove per-skill install example from B2C CLI section --- README.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/README.md b/README.md index 1bebd82..48b91e2 100644 --- a/README.md +++ b/README.md @@ -232,9 +232,6 @@ npx @salesforce/b2c-cli setup skills cap-dev --ide cursor # Install globally (user scope) npx @salesforce/b2c-cli setup skills cap-dev --ide cursor --global - -# Install specific skills only -npx @salesforce/b2c-cli setup skills cap-dev --skill validate-app --skill package-app --ide cursor ``` #### Manual Installation From 5fc9ed4a7d26acae2ee5f9ae6963816bafc8c412 Mon Sep 17 00:00:00 2001 From: Charles Lavery Date: Wed, 22 Apr 2026 16:47:21 -0400 Subject: [PATCH 7/7] Bump marketplace and plugin version to 1.0.0 --- .claude-plugin/marketplace.json | 2 +- .claude/.codex-plugin/plugin.json | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index f934353..b9f48fe 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -1,7 +1,7 @@ { "name": "commerce-apps", "description": "Commerce Apps development skills for building, validating, and submitting Salesforce Commerce Cloud app packages.", - "version": "0.0.1", + "version": "1.0.0", "owner": { "name": "Salesforce" }, diff --git a/.claude/.codex-plugin/plugin.json b/.claude/.codex-plugin/plugin.json index 38baf13..d3a4096 100644 --- a/.claude/.codex-plugin/plugin.json +++ b/.claude/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "cap-dev", - "version": "0.0.1", + "version": "1.0.0", "description": "Skills for scaffolding, packaging, validating, and submitting Commerce App Packages (CAPs) for Salesforce Commerce Cloud.", "author": { "name": "Salesforce"