[clavery]

Summary

The MCP now bundles the cap-dev skills for authoring Commerce App Packages (scaffold, generate IMPEX, validate, package, submit). They come from the public SalesforceCommerceCloud/commerce-apps repository and are served as the cap-dev collection (skill://cap-dev/...). Before this, MCP users had to install them separately from the commerce-apps marketplace.

How the copy is kept and updated

• packages/b2c-dx-mcp/vendor/cap-dev/skills/ is a copy of the upstream .claude/skills Markdown. source.json records the upstream commit (currently 24232f4, the latest on main).
• Refresh it with pnpm --filter @salesforce/b2c-dx-mcp run sync:cap-dev-skills [-- --ref <branch|tag|sha>], then commit with an MCP patch changeset. vendor/cap-dev/README.md covers the steps and says not to edit the copy here. The copy does not follow upstream automatically; it changes only when someone runs the sync.
• The sync copies only Markdown, because the MCP serves nothing else. It leaves out upstream evals/, scripts/ and assets/. Links into the upstream shared/ folder are rewritten to a copy inside each skill so the bundled skills are self-contained. Steps that call upstream scripts or templates still assume a checkout of commerce-apps, and the skills include manual fallbacks.

Shorter skill index

Adding the collection pushed the generated skill://index resource past its 16 KiB budget. That budget is now 24 KiB, and each skill has a short summary of up to 100 characters for the index, in packages/b2c-dx-mcp/skills/index-summaries.json. The index drops from about 17.1 KB to 14.4 KB. The summaries are used only in the index; skill descriptions, skills_read results, the skills extension, and search keep the full SKILL.md description. A test requires every bundled skill to have a summary, so new skills need one.

The SDK's bundleGuidance gains an optional indexSummaries option for this. Callers that don't pass it get the same output as before.

Docs and skills: the Agent Skills and Commerce Apps guides now say the MCP includes cap-dev, the MCP server skill lists the collection, and the b2c-cap skill tells MCP users where to start.

Testing

No manual testing beyond the automated checks. To try it, start the MCP from this branch and confirm skills_read({collection: "cap-dev"}) lists the eight skills and that skill://index shows the short summaries.

[github-actions]

📘 Docs preview

Your documentation changes are published at:

https://d3uhw92m2zac57.cloudfront.net/pr-840/

Commit 36eea0d · ✅ Published

_{This preview updates on every push and is removed when the PR is closed.}