feat(skills): add multi-IDE install support, onboarding skill, and validation scripts

- Add Codex marketplace (.agents/plugins/marketplace.json) and per-plugin
  .codex-plugin/plugin.json manifests for b2c-cli, b2c, b2c-dx-mcp
- Ship logo.svg in each plugin's assets/ dir (sourced from docs/public/logo.svg)
- Add per-plugin README.md with install commands for Claude Code, GitHub
  Copilot (VS Code + CLI), and Codex
- Remove b2c-experimental from the published marketplace
- Add b2c-onboarding skill: IDE detection, CLI verify, setup, sandbox,
  first deploy, goal-routing handoff
- Add optional auth-free validation scripts:
  * skills/b2c/skills/b2c-metadata/scripts/validate.mjs (XSD via xmllint)
  * skills/b2c-cli/skills/b2c-config/scripts/validate.mjs (dw.json lint)
- Update README.md and docs/guide/agent-skills.md with the new install
  paths for Copilot (VS Code + CLI) and Codex

Author: clavery

.agents/plugins/marketplace.json

@@ -0,0 +1,44 @@
+{
+  "name": "b2c-developer-tooling",
+  "interface": {
+    "displayName": "B2C Developer Tooling"
+  },
+  "plugins": [
+    {
+      "name": "b2c-cli",
+      "source": {
+        "source": "local",
+        "path": "./skills/b2c-cli"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Productivity"
+    },
+    {
+      "name": "b2c",
+      "source": {
+        "source": "local",
+        "path": "./skills/b2c"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Productivity"
+    },
+    {
+      "name": "b2c-dx-mcp",
+      "source": {
+        "source": "local",
+        "path": "./plugins/b2c-dx-mcp"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Productivity"
+    }
+  ]
+}

.claude-plugin/marketplace.json

@@ -29,17 +29,6 @@
       "category": "productivity",
       "strict": false
     },
-    {
-      "name": "b2c-experimental",
-      "description": "Experimental B2C Commerce skills including scaffold templates. Not installed by default.",
-      "author": {
-        "name": "Salesforce"
-      },
-      "license": "Apache-2.0",
-      "source": "./skills/b2c-experimental",
-      "category": "productivity",
-      "strict": false
-    },
     {
       "name": "b2c-dx-mcp",
       "description": "MCP server for AI-assisted Salesforce B2C Commerce development with project-aware tooling for common workflows.",

README.md

@@ -10,6 +10,44 @@ Salesforce B2C Commerce Command Line Tools.
 > [!TIP]
 > **Just looking for the B2C CLI or MCP install instructions?** Visit the documentation site at [https://salesforcecommercecloud.github.io/b2c-developer-tooling/](https://salesforcecommercecloud.github.io/b2c-developer-tooling/) for the latest install guide and CLI reference.
 
+## Agent Skills & Plugins
+
+Install B2C Commerce agent skills and plugins in your AI-powered editor. Four plugins are available: `b2c-cli` (CLI operations), `b2c` (development patterns), `b2c-experimental` (scaffolds), and `b2c-dx-mcp` (MCP server).
+
+- **Claude Code**: run these commands in chat:
+
+    ```
+    /plugin marketplace add SalesforceCommerceCloud/b2c-developer-tooling
+    /plugin install b2c-cli@b2c-developer-tooling
+    /plugin install b2c@b2c-developer-tooling
+    /plugin install b2c-dx-mcp@b2c-developer-tooling
+    ```
+
+- **VS Code (GitHub Copilot)**: Command Palette (`Cmd+Shift+P` / `Ctrl+Shift+P`) → **Chat: Install Plugin From Source** → enter the repo `SalesforceCommerceCloud/b2c-developer-tooling`. VS Code Copilot reads the same `.claude-plugin/` marketplace as Claude Code.
+
+- **GitHub Copilot CLI**: also reads the same marketplace.
+
+    ```
+    copilot plugin marketplace add SalesforceCommerceCloud/b2c-developer-tooling
+    copilot plugin install b2c-cli@b2c-developer-tooling
+    copilot plugin install b2c@b2c-developer-tooling
+    copilot plugin install b2c-dx-mcp@b2c-developer-tooling
+    ```
+
+- **Cursor**: add the marketplace from this repo URL in Cursor Settings → Plugins, then install `b2c-cli` / `b2c`.
+
+- **Codex CLI**: run `/plugins` and add from this repo (GitHub URL).
+
+- **Gemini CLI**: `gemini extensions install https://github.com/SalesforceCommerceCloud/b2c-developer-tooling`
+
+- **Any supported IDE (file-copy install via CLI)**:
+
+    ```
+    npx @salesforce/b2c-cli setup skills
+    ```
+
+For Windsurf, OpenCode, Agentforce Vibes, manual installs, and the full install matrix, see [docs/guide/agent-skills](https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/agent-skills).
+
 ## Packages
 
 This is a pnpm monorepo with the following packages:

docs/guide/agent-skills.md

@@ -6,7 +6,9 @@ description: AI agent skills and plugins for Agentforce Vibes, Claude Code, Code
 
 The B2C Developer Tooling project provides agent skills and plugins that enhance the AI-assisted development experience when working with Salesforce B2C Commerce projects.
 
-Skills plugins follow the [Agent Skills](https://agentskills.io/home) standard and can be used with multiple agentic IDEs including [Claude Code](https://claude.ai/code), Cursor, GitHub Copilot, and VS Code. The marketplace also includes an MCP server plugin (`b2c-dx-mcp`).
+Skills plugins follow the [Agent Skills](https://agentskills.io/home) standard and can be used with multiple agentic IDEs including [Claude Code](https://claude.ai/code), GitHub Copilot (VS Code and CLI), Cursor, Codex, and Gemini CLI. The marketplace also includes an MCP server plugin (`b2c-dx-mcp`).
+
+The `.claude-plugin/` marketplace in this repository is read natively by both **Claude Code** and **GitHub Copilot** (VS Code and CLI), so the same install commands work across those clients.
 
 ## Overview
 
@@ -119,6 +121,34 @@ To remove the marketplace:
 claude plugin marketplace remove b2c-developer-tooling
 ```
 
+## Installation with GitHub Copilot
+
+GitHub Copilot reads the same `.claude-plugin/` marketplace as Claude Code, so the plugins install natively in both **VS Code** and the **Copilot CLI**.
+
+### VS Code (GitHub Copilot)
+
+Open the Command Palette (`Cmd+Shift+P` / `Ctrl+Shift+P`) and run **Chat: Install Plugin From Source**. When prompted, enter the repo:
+
+```
+SalesforceCommerceCloud/b2c-developer-tooling
+```
+
+Install the plugins you want (`b2c-cli`, `b2c`, `b2c-dx-mcp`) from the picker.
+
+### GitHub Copilot CLI
+
+```bash
+# Add the marketplace
+copilot plugin marketplace add SalesforceCommerceCloud/b2c-developer-tooling
+
+# Install plugins
+copilot plugin install b2c-cli@b2c-developer-tooling
+copilot plugin install b2c@b2c-developer-tooling
+copilot plugin install b2c-dx-mcp@b2c-developer-tooling
+```
+
+Refer to the [Copilot CLI plugin reference](https://docs.github.com/en/copilot/reference/copilot-cli-reference/cli-plugin-reference) for marketplace and install commands.
+
 ## Installation with Skills CLI
 
 The [Skills CLI](https://github.com/vercel-labs/skills) provides a way to install agent skills to supported IDEs. Use this for the skills plugins (`b2c` and `b2c-cli`), not for the MCP server plugin (`b2c-dx-mcp`).
@@ -258,21 +288,20 @@ Skills are installed to:
 
 ### VS Code with GitHub Copilot
 
-See the [VS Code Agent Skills documentation](https://code.visualstudio.com/docs/copilot/customization/agent-skills) for configuration instructions.
+The recommended install path uses the native plugin marketplace — see [Installation with GitHub Copilot](#installation-with-github-copilot) above.
+
+If you need a file-copy install (for example, to pin a specific skill version to a project), `b2c setup skills --ide vscode` copies skills to:
 
-Skills are installed to:
 - **Project scope**: `.github/skills/` in your project
 - **User scope**: `~/.copilot/skills/`
 
-You can also append skill content to `.github/copilot-instructions.md` in your repository.
-
 ### Codex CLI
 
-See the [Codex documentation](https://github.com/openai/codex) for configuration instructions.
+Codex reads plugin marketplaces from `.agents/plugins/marketplace.json`. This repository ships one at the repo root covering all three plugins (`b2c-cli`, `b2c`, `b2c-dx-mcp`).
 
-Skills are installed to:
-- **Project scope**: `.codex/skills/` in your project
-- **User scope**: `~/.codex/skills/`
+To use it, clone or open the repository as a workspace, then restart Codex — the **B2C Developer Tooling** marketplace appears in the plugin directory, from which you can install any of the listed plugins.
+
+For a personal install across all projects, copy one or more plugin folders (e.g. `skills/b2c-cli/`) to `~/.codex/plugins/<plugin-name>/` and add an entry for each in `~/.agents/plugins/marketplace.json` (see the [Codex plugin build guide](https://developers.openai.com/codex/plugins/build) for the marketplace schema).
 
 ### OpenCode
 

plugins/b2c-dx-mcp/.codex-plugin/plugin.json

@@ -0,0 +1,38 @@
+{
+  "name": "b2c-dx-mcp",
+  "version": "0.0.1",
+  "description": "MCP server for AI-assisted Salesforce B2C Commerce development with project-aware tooling for common workflows.",
+  "author": {
+    "name": "Salesforce"
+  },
+  "homepage": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/",
+  "repository": "https://github.com/SalesforceCommerceCloud/b2c-developer-tooling",
+  "license": "Apache-2.0",
+  "keywords": [
+    "salesforce",
+    "b2c-commerce",
+    "commerce-cloud",
+    "sfra",
+    "scapi",
+    "ocapi"
+  ],
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "B2C DX MCP",
+    "shortDescription": "MCP server for project-aware B2C Commerce workflows.",
+    "longDescription": "Model Context Protocol server providing AI-assisted Salesforce B2C Commerce workflows with project-aware tooling.",
+    "developerName": "Salesforce",
+    "category": "Productivity",
+    "capabilities": [
+      "Read"
+    ],
+    "logo": "./assets/logo.svg",
+    "composerIcon": "./assets/logo.svg",
+    "brandColor": "#0D9DDA",
+    "websiteURL": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/",
+    "defaultPrompt": [
+      "Show me available B2C MCP tools",
+      "Run a B2C project workflow"
+    ]
+  }
+}

plugins/b2c-dx-mcp/README.md

@@ -0,0 +1,29 @@
+# b2c-dx-mcp
+
+MCP server for AI-assisted Salesforce B2C Commerce development, providing project-aware tooling for common workflows.
+
+Part of the [B2C Developer Tooling](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling) marketplace.
+
+## Installation
+
+**Claude Code** and **GitHub Copilot CLI** both read the same `.claude-plugin/` marketplace:
+
+```bash
+# Claude Code
+claude plugin marketplace add SalesforceCommerceCloud/b2c-developer-tooling
+claude plugin install b2c-dx-mcp@b2c-developer-tooling
+
+# GitHub Copilot CLI
+copilot plugin marketplace add SalesforceCommerceCloud/b2c-developer-tooling
+copilot plugin install b2c-dx-mcp@b2c-developer-tooling
+```
+
+**VS Code (GitHub Copilot):** Command Palette → **Chat: Install Plugin From Source** → enter the repo `SalesforceCommerceCloud/b2c-developer-tooling`.
+
+**Codex:** open the repo as a workspace, restart Codex, then install from the **B2C Developer Tooling** marketplace in the plugin directory.
+
+For standalone MCP setup and configuration, see the [MCP Server Overview](https://salesforcecommercecloud.github.io/b2c-developer-tooling/mcp/) and [MCP Installation](https://salesforcecommercecloud.github.io/b2c-developer-tooling/mcp/installation).
+
+## License
+
+Apache-2.0. See the [repo LICENSE](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/main/LICENSE.txt).

plugins/b2c-dx-mcp/assets/logo.svg

@@ -0,0 +1,40 @@
+{
+  "name": "b2c-cli",
+  "version": "0.0.1",
+  "description": "B2C CLI Skills for Salesforce Commerce Cloud development.",
+  "author": {
+    "name": "Salesforce"
+  },
+  "homepage": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/",
+  "repository": "https://github.com/SalesforceCommerceCloud/b2c-developer-tooling",
+  "license": "Apache-2.0",
+  "keywords": [
+    "salesforce",
+    "b2c-commerce",
+    "commerce-cloud",
+    "sfra",
+    "scapi",
+    "ocapi"
+  ],
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "B2C CLI",
+    "shortDescription": "Use the Salesforce B2C Commerce CLI from your AI assistant.",
+    "longDescription": "Skills for driving the Salesforce B2C Commerce CLI — deploy cartridges, run jobs, manage On-Demand Sandboxes, stream logs, and perform WebDAV operations without leaving your editor.",
+    "developerName": "Salesforce",
+    "category": "Productivity",
+    "capabilities": [
+      "Read"
+    ],
+    "logo": "./assets/logo.svg",
+    "composerIcon": "./assets/logo.svg",
+    "brandColor": "#0D9DDA",
+    "websiteURL": "https://salesforcecommercecloud.github.io/b2c-developer-tooling/",
+    "defaultPrompt": [
+      "Deploy the cartridges in ./cartridges to my sandbox",
+      "Run the reindex job on my sandbox",
+      "Create a new On-Demand Sandbox with a 48-hour TTL",
+      "Tail the latest error logs from my instance"
+    ]
+  }
+}

skills/b2c-cli/.codex-plugin/plugin.json

@@ -0,0 +1,44 @@
+# b2c-cli
+
+Agent skills for driving the Salesforce B2C Commerce CLI — deploy cartridges, run jobs, manage On-Demand Sandboxes, stream logs, and perform WebDAV operations from your AI assistant.
+
+Part of the [B2C Developer Tooling](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling) marketplace.
+
+## Installation
+
+**Claude Code** and **GitHub Copilot CLI** both read the same `.claude-plugin/` marketplace:
+
+```bash
+# Claude Code
+claude plugin marketplace add SalesforceCommerceCloud/b2c-developer-tooling
+claude plugin install b2c-cli@b2c-developer-tooling
+
+# GitHub Copilot CLI
+copilot plugin marketplace add SalesforceCommerceCloud/b2c-developer-tooling
+copilot plugin install b2c-cli@b2c-developer-tooling
+```
+
+**VS Code (GitHub Copilot):** Command Palette → **Chat: Install Plugin From Source** → enter the repo `SalesforceCommerceCloud/b2c-developer-tooling`.
+
+**Codex:** open the repo as a workspace, restart Codex, then install from the **B2C Developer Tooling** marketplace in the plugin directory.
+
+For file-copy install to any supported IDE, use `b2c setup skills b2c-cli`. See the [install guide](https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/agent-skills) for details.
+
+## What's included
+
+Skills covering the major B2C CLI surfaces:
+
+- **`b2c-code`** — cartridge deploy, code version management, watch mode
+- **`b2c-sandbox`** — On-Demand Sandbox lifecycle
+- **`b2c-job`** — job execution and monitoring
+- **`b2c-logs`** — log streaming and log file management
+- **`b2c-webdav`** — WebDAV file operations
+- **`b2c-site-import-export`** — site archive import/export
+- **`b2c-config`** — CLI configuration, auth, and troubleshooting
+- **`b2c-scapi-custom`** — SCAPI Custom API management
+
+See [`skills/`](./skills/) for the full list.
+
+## License
+
+Apache-2.0. See the [repo LICENSE](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/main/LICENSE.txt).