feat: support CAP skills plugin from commerce-apps repo (#373)

Introduce a SkillSource registry to decouple skill download strategy from
installation. Adds cap-dev skill set backed by the commerce-apps repo using
GitHub Contents API with sparse git checkout fallback.

- Widen SkillSet to include 'cap-dev'
- Add SkillSourceConfig interface and source registry (sources.ts)
- Refactor github.ts into dispatcher: release-artifact vs repo-contents
- Replace regex frontmatter parser with js-yaml for block scalar support
- Add cap-dev to Claude Code and Codex marketplace via git-subdir
- Add parser and sources unit tests

Author: clavery

.agents/plugins/marketplace.json

@@ -27,6 +27,26 @@
         "authentication": "ON_INSTALL"
       },
       "category": "Productivity"
+    },
+    {
+      "name": "cap-dev",
+      "description": "Skills for scaffolding, packaging, validating, and submitting Commerce App Packages (CAPs) for Salesforce Commerce Cloud.",
+      "source": {
+        "source": "git-subdir",
+        "url": "SalesforceCommerceCloud/commerce-apps",
+        "path": ".claude",
+        "ref": "feature/codex-copilot-plugin-docs"
+      },
+      "interface": {
+        "displayName": "Commerce Apps Dev",
+        "shortDescription": "Scaffold, validate, package, and submit Commerce App Packages.",
+        "longDescription": "Skills for building Salesforce Commerce Cloud app packages — scaffold new apps (UI-only, backend-only, or fullstack), generate IMPEX configurations for services, custom objects, and site preferences, validate packages against registry requirements, and submit pull requests to the commerce-apps registry."
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Productivity"
     }
   ]
 }

.changeset/cap-plugin-support.md

@@ -0,0 +1,6 @@
+---
+'@salesforce/b2c-cli': minor
+'@salesforce/b2c-tooling-sdk': minor
+---
+
+Add support for Commerce Apps (CAP) development skills via `b2c setup skills cap-dev`. Introduces a skill source registry to support external skill repositories alongside existing release-artifact sources.

.claude-plugin/marketplace.json

@@ -41,6 +41,36 @@
       "source": "./plugins/b2c-dx-mcp",
       "category": "productivity",
       "strict": false
+    },
+    {
+      "name": "cap-dev",
+      "description": "Skills for scaffolding, packaging, validating, and submitting Commerce App Packages (CAPs) for Salesforce Commerce Cloud.",
+      "author": {
+        "name": "Salesforce"
+      },
+      "homepage": "https://github.com/SalesforceCommerceCloud/commerce-apps",
+      "repository": "https://github.com/SalesforceCommerceCloud/commerce-apps",
+      "license": "Apache-2.0",
+      "source": {
+        "source": "git-subdir",
+        "url": "SalesforceCommerceCloud/commerce-apps",
+        "path": ".claude",
+        "ref": "feature/codex-copilot-plugin-docs"
+      },
+      "category": "productivity",
+      "keywords": [
+        "salesforce",
+        "commerce-apps",
+        "commerce-cloud",
+        "cap",
+        "impex"
+      ],
+      "interface": {
+        "displayName": "Commerce Apps Dev",
+        "shortDescription": "Scaffold, validate, package, and submit Commerce App Packages.",
+        "longDescription": "Skills for building Salesforce Commerce Cloud app packages — scaffold new apps (UI-only, backend-only, or fullstack), generate IMPEX configurations for services, custom objects, and site preferences, validate packages against registry requirements, and submit pull requests to the commerce-apps registry."
+      },
+      "strict": false
     }
   ]
 }

packages/b2c-cli/src/commands/setup/skills.ts

@@ -12,6 +12,8 @@ import {
   type SkillMetadata,
   type InstallSkillsResult,
   ALL_IDE_TYPES,
+  ALL_SKILL_SETS,
+  SKILL_SOURCES,
   detectInstalledIdes,
   downloadSkillsArtifact,
   scanSkills,
@@ -60,8 +62,8 @@ interface SetupSkillsResponse {
 export default class SetupSkills extends BaseCommand<typeof SetupSkills> {
   static args = {
     skillset: Args.string({
-      description: 'Skill set to install: b2c or b2c-cli',
-      options: ['b2c', 'b2c-cli'],
+      description: 'Skill set to install: b2c, b2c-cli, or cap-dev',
+      options: ALL_SKILL_SETS,
     }),
   };
 
@@ -75,6 +77,7 @@ export default class SetupSkills extends BaseCommand<typeof SetupSkills> {
   static examples = [
     '<%= config.bin %> <%= command.id %> b2c',
     '<%= config.bin %> <%= command.id %> b2c-cli --ide cursor --global',
+    '<%= config.bin %> <%= command.id %> cap-dev --ide claude-code --global',
     '<%= config.bin %> <%= command.id %> b2c --list',
     '<%= config.bin %> <%= command.id %> b2c-cli --skill b2c-code --skill b2c-webdav --ide cursor',
     '<%= config.bin %> <%= command.id %> b2c --global --update --force',
@@ -130,16 +133,16 @@ export default class SetupSkills extends BaseCommand<typeof SetupSkills> {
       this.error(
         t(
           'commands.setup.skills.skillsetRequired',
-          'Skillset argument required in non-interactive mode. Specify b2c or b2c-cli.',
+          'Skillset argument required in non-interactive mode. Specify b2c, b2c-cli, or cap-dev.',
         ),
       );
     } else {
       skillsets = await checkbox({
         message: t('commands.setup.skills.selectSkillset', 'Select skill set(s) to install:'),
-        choices: [
-          {name: 'b2c - B2C Commerce development patterns', value: 'b2c' as SkillSet},
-          {name: 'b2c-cli - B2C CLI commands and operations', value: 'b2c-cli' as SkillSet},
-        ],
+        choices: ALL_SKILL_SETS.map((id) => ({
+          name: `${id} - ${SKILL_SOURCES[id].displayName}`,
+          value: id,
+        })),
       });
       if (skillsets.length === 0) {
         ux.stdout(t('commands.setup.skills.noSkillsetsSelected', 'No skill sets selected.'));
@@ -148,11 +151,23 @@ export default class SetupSkills extends BaseCommand<typeof SetupSkills> {
     }
 
     // Download and scan skills
-    this.log(
-      t('commands.setup.skills.downloading', 'Downloading skills from release {{version}}...', {
-        version: this.flags.version || 'latest',
-      }),
-    );
+    const hasReleaseArtifacts = skillsets.some((s) => SKILL_SOURCES[s].type === 'release-artifact');
+    const hasRepoContents = skillsets.some((s) => SKILL_SOURCES[s].type === 'repo-contents');
+    if (hasReleaseArtifacts && hasRepoContents) {
+      this.log(t('commands.setup.skills.downloading', 'Downloading skills...'));
+    } else if (hasRepoContents) {
+      this.log(
+        t('commands.setup.skills.downloadingRepo', 'Downloading skills from repository ({{ref}})...', {
+          ref: this.flags.version || 'main',
+        }),
+      );
+    } else {
+      this.log(
+        t('commands.setup.skills.downloadingRelease', 'Downloading skills from release {{version}}...', {
+          version: this.flags.version || 'latest',
+        }),
+      );
+    }
 
     // Download skills for all skillsets in parallel
     const downloadResults = await Promise.all(

packages/b2c-tooling-sdk/package.json

@@ -427,6 +427,7 @@
     "@salesforce/dev-config": "catalog:",
     "@types/chai": "catalog:",
     "@types/ejs": "^3.1.5",
+    "@types/js-yaml": "4.0.9",
     "@types/mocha": "catalog:",
     "@types/node": "catalog:",
     "@types/sinon": "catalog:",
@@ -468,6 +469,7 @@
     "fuse.js": "7.1.0",
     "glob": "catalog:",
     "i18next": "25.7.4",
+    "js-yaml": "4.1.1",
     "jsonschema": "catalog:",
     "jszip": "3.10.1",
     "minimatch": "10.1.1",