b2c-onboarding

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):

# 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:

• SFRA (Storefront Reference Architecture): https://github.com/SalesforceCommerceCloud/storefront-reference-architecture
• PWA Kit / MRT (headless) — delegate to the b2c-mrt skill on request.

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?

1. Build or modify a storefront (SFRA cartridges, ISML, controllers)
2. Build a Custom API (SCAPI)
3. 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

• B2C CLI reference: https://salesforcecommercecloud.github.io/b2c-developer-tooling/cli/
• Install guide: https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/install
• Agent skills overview: https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/agent-skills