Agent-Skills.md

Agent Skills: B2C Commerce Onboarding Skill

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

UncategorizedID: salesforcecommercecloud/b2c-developer-tooling/b2c-onboarding

Repository

salesforcecommercecloud/b2c-developer-tooling
SalesforceCommerceCloudLicense: Apache-2.0
4612

Install this agent skill to your local

pnpm dlx add-skill https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/tree/HEAD/skills/b2c/skills/b2c-onboarding

Skill Files

Browse the full folder contents for b2c-onboarding.

Download Skill

Loading file tree…

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

Skill Metadata

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 — Claude Code only) | | 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 | Open the repo as a workspace, restart Codex, then install b2c-cli from the B2C Developer Tooling marketplace in the plugin directory | | 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 other than Claude Code, the b2c-dx-mcp 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