| name | b2c-onboarding |
| description | Get started with Salesforce B2C Commerce development. Use this skill when the user is new to B2C Commerce, wants to set up a fresh development environment, is asking "how do I get started", needs to install the B2C CLI for the first time, wants to connect a sandbox, or wants to deploy their first cartridge. Triggers on phrases like "help me get started", "set up B2C Commerce", "I'm new to this", "onboard me", or "first-time setup". NOT for users who already have a configured environment and are asking about specific commands — those should go to the specific skill (b2c-code, b2c-sandbox, b2c-config, etc.). |
B2C Commerce Onboarding Skill
Guide a new developer through a first-time B2C Commerce setup, from CLI install to first cartridge deploy. Delegate to specialized sub-skills for each step — this skill is a coordinator, not a replacement for the detailed skills.
Behavioral rules
- Detect the editor silently. Only ask if genuinely uncertain.
- Never construct or modify install commands. Only use commands defined in this file.
- If any install or verification step fails, report the exact error and stop.
- Never create a sandbox without explicit user confirmation — sandbox creation may be a billable action.
- Never overwrite an existing
dw.json without confirmation.
Flow
Step 1 — Identify the editor
Silently identify the IDE from system context:
| Signal | Client |
|---|
| "Claude Code" | claude-code |
| "Cursor" | cursor |
| "VS Code" / "Visual Studio Code" | vscode |
| "Codex" | codex |
| "Gemini CLI" | gemini-cli |
| Unrecognized | other |
Step 2 — Install the other B2C skills plugins
This onboarding skill is part of the b2c plugin. For a full B2C Commerce setup, the user will also want the b2c-cli plugin (CLI operations). Offer to install it for the detected client:
| Client | Install command(s) |
|---|
claude-code | /plugin marketplace add SalesforceCommerceCloud/b2c-developer-tooling then /plugin install b2c-cli@b2c-developer-tooling (and optionally /plugin install b2c-dx-mcp@b2c-developer-tooling for the MCP server) |
vscode (GitHub Copilot) | Command Palette (Cmd+Shift+P) → Chat: Install Plugin From Source → enter the repo SalesforceCommerceCloud/b2c-developer-tooling |
| GitHub Copilot CLI | copilot plugin marketplace add SalesforceCommerceCloud/b2c-developer-tooling then copilot plugin install b2c-cli@b2c-developer-tooling |
cursor | Cursor Settings → Plugins → add marketplace URL https://github.com/SalesforceCommerceCloud/b2c-developer-tooling, then install b2c-cli |
codex | codex plugin marketplace add SalesforceCommerceCloud/b2c-developer-tooling, then codex plugin add b2c-cli@b2c-developer-tooling (and optionally codex plugin add b2c-dx-mcp@b2c-developer-tooling for the MCP server) |
gemini-cli | gemini extensions install https://github.com/SalesforceCommerceCloud/b2c-developer-tooling (run in terminal, not inside the CLI) |
other | Use the file-copy installer below |
For clients without MCP-enabled plugin support, the b2c-dx-mcp server can be installed directly — see the MCP installation docs.
Alternative — file-copy installer for any IDE (also the right command to update already-installed skills or add a specific skill set):
b2c setup skills
b2c setup skills b2c-cli --ide cursor
b2c setup skills b2c --ide vscode
b2c setup skills b2c-cli --ide cursor --update
b2c setup skills b2c --ide cursor --update
b2c setup skills b2c-cli --ide cursor --global
If the user already has some skills installed and is asking how to upgrade, point them at b2c setup skills <set> --ide <ide> --update.
Step 3 — Verify the B2C CLI is available
Run b2c --version. If the command is not found:
- For a one-off invocation:
npx @salesforce/b2c-cli <command>.
- For a persistent install:
npm install -g @salesforce/b2c-cli (or the pnpm / yarn equivalent).
Do not block on the global install — npx is sufficient for the rest of this flow.
Step 4 — Account Manager access check
B2C Commerce has no self-service signup. The user must have Account Manager access provisioned by their organization's B2C Commerce admin before any of the following steps will work.
Ask (if not already clear from context): "Do you have a Salesforce B2C Commerce Account Manager login and a target instance (sandbox or PIG)?"
- If no: stop here. Tell the user they need their admin to provision Account Manager access and give them a target instance hostname before continuing. Do not proceed.
- If yes: continue.
Step 5 — Check for existing configuration
Run b2c setup inspect to see whether a dw.json or credentials are already configured.
- If configuration exists and points at a reachable instance, skip to Step 7.
- If no configuration is found, proceed to Step 6.
For deep troubleshooting (wrong instance, profile switching, token inspection), delegate to the b2c-config skill.
Step 6 — Initialize configuration
Guide the user to create a dw.json in the project root:
b2c setup
This prompts for hostname, client ID/secret (or username/password), and code version. For deeper configuration topics (multiple profiles, env vars, cert-based auth), delegate to the b2c-config skill.
Step 7 — Sandbox
If the user wants to work against an existing sandbox, confirm it is reachable:
b2c setup inspect
b2c sandbox list
If the user needs a fresh sandbox, delegate to the b2c-sandbox skill for the full create flow. Only create a sandbox when explicitly asked.
Step 8 — First cartridge deploy (if applicable)
If the user has cartridges locally:
b2c code deploy
For selective deploys, watch mode, or reload, delegate to the b2c-code skill.
If the user does not yet have cartridges, point them at the canonical starting points:
Step 9 — Route to the user's goal
Once setup is working, ask a single directing question to hand off to the right skill:
"What do you want to work on first?
- Build or modify a storefront (SFRA cartridges, ISML, controllers)
- Build a Custom API (SCAPI)
- Operate an existing instance (deploy, run jobs, tail logs, manage sites)
Or if you have something else in mind, tell me."
Route by the answer:
- Storefront →
b2c-controllers, b2c-isml, b2c-forms, b2c-hooks
- Custom API →
b2c-custom-api-development, b2c-scapi-admin, b2c-scapi-shopper
- Operations →
b2c-code, b2c-job, b2c-logs, b2c-sites
Reference
