Skills & Guidance

Generate SFCC skills, Cursor rules, and Copilot instructions with the correct project destinations and tool workflows

Turn recurring SFCC tasks into project-local guidance. The extension's catalog of 37 skills across 11 topics 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

Pick your agent's format once, find the skill for the job, review what it tells the agent, then add it to the project as that agent's own instruction files

Built-in guidance is already available through MCP. Generated files put those workflows into your coding agent's own project instruction format, with 15 formats including Codex, Claude Code, Cursor, and GitHub Copilot. 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 controller: the catalog narrows to four skills, including 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

Add a skill from the context menu

Right-click a file or folder in the Explorer, or inside an open editor, and choose B2C Add Skill. The files go into the workspace folder that contains what you clicked

  1. In Create an SFCC MCP skill package in this workspace, pick All SFCC MCP skills, a Group: entry for one topic, or a single skill. Each skill shows its topic and destination path
  2. Choose the agent format. Each format shows where its files will be written
  3. A single skill is written right away and its primary file opens. A group or the full catalog asks you to confirm with Add Skills first

Existing files are never overwritten; a notification reports how many files were created and how many already existed

Choose your agent format

For SFRA Controller Routes & Overrides, the generated destinations are:

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

Codex skill package
.agents/skills/sfcc-sfra-controller-routes/
  SKILL.md
  agents/openai.yaml
  references/mcp-tool-map.md
  scripts/print-mcp-workflow.mjs

The 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 Skill format menu lists every format the panel writes, with its destination pattern:

Skill formatDestination pattern
Codex / Agent Skills.agents/skills/<skill>/SKILL.md
OpenCode native skill.opencode/skills/<skill>/SKILL.md
Claude Code skill.claude/skills/<skill>/SKILL.md
Cursor Rules.cursor/rules/<skill>.mdc
GitHub Copilot / VS Code.github/instructions/<skill>.instructions.md
Gemini CLI contextGEMINI.md + .gemini/skills/<skill>.md
Antigravity / Gemini contextGEMINI.md + .gemini/antigravity/skills/<skill>.md
JetBrains Junie guidelines.junie/guidelines.md
Trae IDE AGENTS-compatible.agents/skills/<skill>/SKILL.md
Cline rules.clinerules/<skill>.md
Roo Code rules.roo/rules/<skill>.md
OpenClaw AGENTS-compatible.agents/skills/<skill>/SKILL.md
Hermes Agent AGENTS-compatible.agents/skills/<skill>/SKILL.md
Kimi Code Agent Skills.kimi-code/skills/<skill>/SKILL.md
Generic Agent Skills.agents/skills/<skill>/SKILL.md

All supported agent styles writes every format at once, for a project where people use more than one agent

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 formatDestination
Codex skill.agents/skills/sfcc-lsp/SKILL.md
OpenCode instructions.opencode/sfcc-lsp.md
Claude Code skill.claude/skills/sfcc-lsp/SKILL.md
Claude Code plugin skeleton.claude/plugins/intellijsfcc-sfcc-lsp/ with .claude-plugin/plugin.json, .mcp.json, skills/sfcc-lsp/SKILL.md and README.md
Cursor Rules.cursor/rules/sfcc-lsp-mcp.mdc
Gemini instructionsGEMINI.md
GitHub Copilot instructions.github/copilot-instructions.md
SFRA controller override skillsfcc-sfra-controller-overrides for Codex, Claude Code and Cursor

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 controller skill
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

On this page