Skip to content

Commit 61ee9ac

Browse files
committed
docs(skills): trim implementation details from install page
Install-oriented pages should cover how to install, not how the plugins are wired. Scrub manifest-schema and file-layout language from the agent skills doc, root README, per-plugin READMEs, and the onboarding skill so users see only the install commands they need to run. - Drop "Type" column from Available Plugins; rewrite MCP description. - Remove the "CLI does the actual work" and "drop skills into your IDE's skills directory manually" tagline language. - Collapse the Agentforce manual-install directory table into a single concise reference row in Manual Installation. - Move file-copy destination paths out of the main Other IDEs row into a Manual Installation reference sub-table. - Remove the zip-download block.
1 parent 73ea3cc commit 61ee9ac

6 files changed

Lines changed: 27 additions & 55 deletions

File tree

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,9 +23,9 @@ Install B2C Commerce agent skills and plugins in your AI-powered editor. Four pl
2323
/plugin install b2c-dx-mcp@b2c-developer-tooling
2424
```
2525
26-
- **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.
26+
- **VS Code (GitHub Copilot)**: Command Palette (`Cmd+Shift+P` / `Ctrl+Shift+P`) → **Chat: Install Plugin From Source** → enter the repo `SalesforceCommerceCloud/b2c-developer-tooling`.
2727
28-
- **GitHub Copilot CLI**: also reads the same marketplace.
28+
- **GitHub Copilot CLI**:
2929
3030
```
3131
copilot plugin marketplace add SalesforceCommerceCloud/b2c-developer-tooling

docs/guide/agent-skills.md

Lines changed: 24 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -6,16 +6,12 @@ description: AI agent skills and plugins for Salesforce B2C Commerce — teach A
66

77
Turn your coding agent into a B2C Commerce specialist. Skills give Claude Code, Cursor, Agentforce Vibes, Copilot, and Codex deep platform expertise across the full stack — **SCAPI Custom APIs, SLAS authentication, SFRA controllers and forms, ISML, Page Designer, hooks, custom objects, custom job steps, web services** — and operational workflows like **deploying cartridges, running jobs, debugging 404s and logs, managing On-Demand Sandboxes, MRT/PWA Kit, eCDN, site archives, and IMPEX metadata XML**.
88

9-
Skills follow the open [Agent Skills](https://agentskills.io/home) standard and work with [Agentforce Vibes](#installation-with-agentforce-vibes), [Claude Code](https://claude.ai/code), Cursor, GitHub Copilot (VS Code and CLI), Codex, OpenCode, and others. Skills teach your agent how B2C Commerce works and which B2C CLI commands to run and when — the CLI does the actual work against your instance.
9+
Skills follow the open [Agent Skills](https://agentskills.io/home) standard and work with [Agentforce Vibes](#installation-with-agentforce-vibes), [Claude Code](https://claude.ai/code), Cursor, GitHub Copilot (VS Code and CLI), Codex, OpenCode, and others.
1010

11-
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. **Codex** reads a separate marketplace at `.agents/plugins/marketplace.json` (shipped in the repo root).
12-
13-
Install from your IDE's plugin system (Claude Code below), the B2C CLI (`b2c setup skills`), or by dropping skills into your IDE's skills directory manually.
11+
Install from your IDE's plugin marketplace or the B2C CLI (`b2c setup skills`).
1412

1513
## Quick Start
1614

17-
Install via your IDE's plugin marketplace where supported — otherwise use the B2C CLI installer:
18-
1915
::: code-group
2016

2117
```bash [Agentforce Vibes]
@@ -44,10 +40,9 @@ copilot plugin install b2c@b2c-developer-tooling
4440
```
4541

4642
```text [Codex]
47-
Open this repository as a workspace (Codex reads .agents/plugins/marketplace.json
48-
at the repo root), then restart Codex. The "B2C Developer Tooling" marketplace
49-
appears in the plugin directory — install b2c-cli, b2c, and/or b2c-dx-mcp
50-
from there.
43+
Open this repository as a workspace, then restart Codex. Open the plugin
44+
directory and select the "B2C Developer Tooling" marketplace — install
45+
b2c-cli, b2c, and/or b2c-dx-mcp from there.
5146
```
5247

5348
```bash [B2C CLI]
@@ -56,34 +51,28 @@ npx @salesforce/b2c-cli setup skills
5651

5752
:::
5853

59-
For additional IDEs (Agentforce Vibes, Cursor, Windsurf, OpenCode) and full B2C CLI options see [Installation with B2C CLI](#installation-with-b2c-cli), [Installation with Agentforce Vibes](#installation-with-agentforce-vibes), or [Installation with Other IDEs](#installation-with-other-ides).
60-
6154
## Available Plugins
6255

6356
<table>
6457
<colgroup>
6558
<col style="width: 12rem" />
66-
<col style="width: 6rem" />
6759
<col />
6860
</colgroup>
6961
<thead>
70-
<tr><th>Plugin</th><th>Type</th><th>Description</th></tr>
62+
<tr><th>Plugin</th><th>Description</th></tr>
7163
</thead>
7264
<tbody>
7365
<tr>
7466
<td><a href="https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/tree/main/skills/b2c-cli/skills"><code>b2c-cli</code></a></td>
75-
<td>Skills</td>
7667
<td>B2C CLI commands and operations — code deployment, job execution, site archives, WebDAV, On-Demand Sandbox management</td>
7768
</tr>
7869
<tr>
7970
<td><a href="https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/tree/main/skills/b2c/skills"><code>b2c</code></a></td>
80-
<td>Skills</td>
8171
<td>B2C Commerce development patterns — controllers, ISML, forms, localization, logging, metadata, web services, custom job steps, Page Designer, Business Manager extensions, Custom APIs</td>
8272
</tr>
8373
<tr>
8474
<td><a href="/mcp/"><code>b2c-dx-mcp</code></a></td>
85-
<td>MCP</td>
86-
<td>MCP server for AI-assisted B2C Commerce development with project-aware tooling. See <a href="/mcp/installation">MCP Installation</a></td>
75+
<td>Automatic project type detection and B2C Commerce workflows for your AI assistant. See <a href="/mcp/installation">MCP Installation</a></td>
8776
</tr>
8877
</tbody>
8978
</table>
@@ -126,11 +115,7 @@ claude plugin marketplace remove b2c-developer-tooling
126115

127116
## Install Codex Plugin
128117

129-
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`).
130-
131-
Open this repository as a workspace and restart Codex. The **B2C Developer Tooling** marketplace appears in the plugin directory — install any of the listed plugins from there.
132-
133-
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.
118+
Open this repository as a workspace and restart Codex. Open the plugin directory, select the **B2C Developer Tooling** marketplace, and install any of `b2c-cli`, `b2c`, or `b2c-dx-mcp`.
134119

135120
## Installation with B2C CLI
136121

@@ -194,28 +179,19 @@ b2c setup skills b2c-cli --ide agentforce-vibes
194179
b2c setup skills b2c --ide agentforce-vibes --global
195180
```
196181

197-
Manual install directories:
198-
199-
| Location | Scope |
200-
|----------|-------|
201-
| `.a4drules/skills/` | Project |
202-
| `~/Library/Application Support/Code/User/globalStorage` | Global (macOS) |
203-
| `~/.config/Code/User/globalStorage` | Global (Linux) |
204-
| `%APPDATA%\Code\User\globalStorage` | Global (Windows) |
205-
206182
## Installation with Other IDEs
207183

208184
::: tip
209185
Use [`b2c setup skills`](/cli/setup) for any supported IDE.
210186
:::
211187

212-
| IDE | Flag | Project | User |
213-
|-----|------|---------|------|
214-
| [Cursor](https://cursor.com/docs/context/skills) | `--ide cursor` | `.cursor/skills/` | `~/.cursor/skills/` |
215-
| [Windsurf](https://docs.windsurf.com/) | `--ide windsurf` | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
216-
| [VS Code / Copilot](https://code.visualstudio.com/docs/copilot/customization/agent-skills) | `--ide vscode` | `.github/skills/` | `~/.copilot/skills/` |
217-
| [Codex CLI](https://github.com/openai/codex) | `--ide codex` | `.codex/skills/` | `~/.codex/skills/` |
218-
| [OpenCode](https://opencode.ai/) | `--ide opencode` | `.opencode/skills/` | `~/.config/opencode/skills/` |
188+
| IDE | Flag |
189+
|-----|------|
190+
| [Cursor](https://cursor.com/docs/context/skills) | `--ide cursor` |
191+
| [Windsurf](https://docs.windsurf.com/) | `--ide windsurf` |
192+
| [VS Code / Copilot](https://code.visualstudio.com/docs/copilot/customization/agent-skills) | `--ide vscode` |
193+
| [Codex CLI](https://github.com/openai/codex) | `--ide codex` |
194+
| [OpenCode](https://opencode.ai/) | `--ide opencode` |
219195

220196
### Manual Installation
221197

@@ -226,14 +202,16 @@ b2c setup skills b2c --ide manual
226202
b2c setup skills b2c --ide manual --directory ./my-skills
227203
```
228204

229-
Or download skill zips from the [latest release](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/releases/latest):
205+
For reference, the install locations each `--ide` flag writes to:
230206

231-
```bash
232-
curl -LO https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/releases/latest/download/b2c-cli-skills.zip
233-
curl -LO https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/releases/latest/download/b2c-skills.zip
234-
unzip b2c-cli-skills.zip -d /path/to/your/ide/skills/
235-
unzip b2c-skills.zip -d /path/to/your/ide/skills/
236-
```
207+
| IDE | Project | User |
208+
|-----|---------|------|
209+
| Cursor | `.cursor/skills/` | `~/.cursor/skills/` |
210+
| Windsurf | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
211+
| VS Code / Copilot | `.github/skills/` | `~/.copilot/skills/` |
212+
| Codex CLI | `.codex/skills/` | `~/.codex/skills/` |
213+
| OpenCode | `.opencode/skills/` | `~/.config/opencode/skills/` |
214+
| Agentforce Vibes | `.a4drules/skills/` | IDE's global storage |
237215

238216
## Usage Examples
239217

plugins/b2c-dx-mcp/README.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,6 @@ Part of the [B2C Developer Tooling](https://github.com/SalesforceCommerceCloud/b
66

77
## Installation
88

9-
**Claude Code** and **GitHub Copilot CLI** both read the same `.claude-plugin/` marketplace:
10-
119
```bash
1210
# Claude Code
1311
claude plugin marketplace add SalesforceCommerceCloud/b2c-developer-tooling

skills/b2c-cli/README.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,6 @@ Part of the [B2C Developer Tooling](https://github.com/SalesforceCommerceCloud/b
66

77
## Installation
88

9-
**Claude Code** and **GitHub Copilot CLI** both read the same `.claude-plugin/` marketplace:
10-
119
```bash
1210
# Claude Code
1311
claude plugin marketplace add SalesforceCommerceCloud/b2c-developer-tooling

skills/b2c/README.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,6 @@ Part of the [B2C Developer Tooling](https://github.com/SalesforceCommerceCloud/b
66

77
## Installation
88

9-
**Claude Code** and **GitHub Copilot CLI** both read the same `.claude-plugin/` marketplace:
10-
119
```bash
1210
# Claude Code
1311
claude plugin marketplace add SalesforceCommerceCloud/b2c-developer-tooling

skills/b2c/skills/b2c-onboarding/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ This onboarding skill is part of the `b2c` plugin. For a full B2C Commerce setup
4040
| `vscode` (GitHub Copilot) | Command Palette (Cmd+Shift+P) → **Chat: Install Plugin From Source** → enter the repo `SalesforceCommerceCloud/b2c-developer-tooling` |
4141
| GitHub Copilot CLI | `copilot plugin marketplace add SalesforceCommerceCloud/b2c-developer-tooling` then `copilot plugin install b2c-cli@b2c-developer-tooling` and `copilot plugin install b2c-dx-mcp@b2c-developer-tooling` |
4242
| `cursor` | Cursor Settings → Plugins → add marketplace URL `https://github.com/SalesforceCommerceCloud/b2c-developer-tooling`, then install `b2c-cli` and `b2c-dx-mcp` |
43-
| `codex` | Open the repo as a workspace (Codex reads `.agents/plugins/marketplace.json` at the repo root), restart Codex, then install `b2c-cli` / `b2c` / `b2c-dx-mcp` from the **B2C Developer Tooling** marketplace in the plugin directory |
43+
| `codex` | Open the repo as a workspace, restart Codex, then install `b2c-cli` / `b2c` / `b2c-dx-mcp` from the **B2C Developer Tooling** marketplace in the plugin directory |
4444
| `gemini-cli` | `gemini extensions install https://github.com/SalesforceCommerceCloud/b2c-developer-tooling` (run in terminal, not inside the CLI) |
4545
| `other` | Use the file-copy installer below |
4646

0 commit comments

Comments
 (0)