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.).
Instrucciones de origen · Vista previa de solo lectura
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
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):
# Interactive: select skill sets and IDEs
b2c setup skills
# Install a specific skill set to a specific IDE
b2c setup skills b2c-cli --ide cursor
b2c setup skills b2c --ide vscode
# Update existing skills to the latest release
b2c setup skills b2c-cli --ide cursor --update
b2c setup skills b2c --ide cursor --update
# Install globally (all projects)
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 # requires API access
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:
