Turn recurring SFCC tasks into project-local guidance. The extension's skill catalog covers workflows such as controller overrides, ISML templates, metadata, APIs, logs, deployment, and debugging. Each skill explains when to use it, which MCP tools provide the required context, and how to check the result.
Built-in guidance is already available through MCP. Generated files put those workflows into your coding agent's own project instruction format. Adding a skill writes local instruction files; it does not change your sandbox or tool access.
Add your first skill
Choose a format and workspace
Open B2C MCP → Skills & Guidance. Select Skill format, then Save project files in. In a multi-root workspace, this folder receives the generated files; the MCP server still covers the open workspace and linked cartridges.
Find a recurring task
Choose a Topic or search the catalog. For route work, search for SFRA Controller Routes & Overrides. Skills also match their triggers, MCP tool names, and related plugin features.
Review the generated guidance
Open View details to review triggers, the tool workflow, destination, and available files. Use Open preview to inspect the generated instructions before adding them.
Add the files
Select Add to project. The extension creates missing files and opens the primary instruction file. An installed skill offers Open installed; existing files are preserved.
Use Add selected topic for a related group, or Add all skills… for the full catalog. Each bulk action shows the selected workspace, file count, and first destination before writing. Copy full catalog copies the catalog as reviewable text instead of installing it.
Choose your agent format
Codex / Agent Skills
Claude Code skill
Cursor Rules
GitHub Copilot / VS Code
For SFRA Controller Routes & Overrides, the generated destinations are:
| Format | Project-relative destination |
|---|---|
| Codex / Agent Skills | .agents/skills/sfcc-sfra-controller-routes/SKILL.md |
| Claude Code skill | .claude/skills/sfcc-sfra-controller-routes/SKILL.md |
| Cursor Rules | .cursor/rules/sfcc-sfra-controller-routes.mdc |
| GitHub Copilot / VS Code | .github/instructions/sfcc-sfra-controller-routes.instructions.md |
The Codex package includes:
.agents/skills/sfcc-sfra-controller-routes/
SKILL.md
agents/openai.yaml
references/mcp-tool-map.md
scripts/print-mcp-workflow.mjsThe Claude package has SKILL.md, references/mcp-tool-map.md, and scripts/print-mcp-workflow.mjs under .claude/skills/sfcc-sfra-controller-routes/. The helper prints the workflow gates and recommended tool names; it does not execute the MCP calls.
Cursor and Copilot generate one rule or instruction file per skill. Cursor's tool map is embedded in its .mdc file. The panel also offers formats for other supported agents and an All supported agent styles option when a project needs more than one format.
Add a project instruction file
The Project instruction file control adds optional base guidance for using SFCC MCP. Choose its Instruction format separately from the catalog's Skill format, then select Copy or Add to project.
| Base instruction format | Destination |
|---|---|
| Codex skill | .agents/skills/sfcc-lsp/SKILL.md |
| Claude Code skill | .claude/skills/sfcc-lsp/SKILL.md |
| Cursor Rules | .cursor/rules/sfcc-lsp-mcp.mdc |
| GitHub Copilot instructions | .github/copilot-instructions.md |
The base guidance establishes the common workflow: confirm the SFCC project, locate the target through MCP, inspect types and override ownership, make the requested change, and validate it. Topic skills add the details for a particular job. Neither file configures the MCP connection; use Connect AI for that.
Example: explain an SFRA override
After connecting your agent and adding the controller skill, try:
Use the SFRA Controller Routes & Overrides guidance to explain
Product-Show in this workspace. Confirm the project, list the indexed
route implementations, follow module.superModule, and identify the
effective owner and middleware order. Include source locations.
Do not change files.The skill directs the agent to tools including intellijsfcc.endpoint.list, intellijsfcc.file.top_override, intellijsfcc.module.super, and intellijsfcc.module.super_graph. For an edit, it also directs the agent to recheck the effective route owner and language-server diagnostics.
Review the result in Activity to confirm that the expected tool calls occurred. Generated guidance helps the agent choose a workflow; the tool responses and validation results provide the evidence.
Update or troubleshoot guidance
- A file already exists: open the installed file, inspect the new preview, and merge the changes you want to keep. Generation does not overwrite existing instructions.
- The agent does not use the skill: check the selected format and destination, then follow the agent's project instruction loading behavior. For Cursor and Copilot, also check the generated file patterns against the file you are working on.
- A referenced tool is unavailable: review Tools & Access and the tool's prerequisites, then refresh the client's MCP tool list. Adding a skill does not enable a disabled tool.
- The catalog appears empty: clear the search and topic filters before searching again.