feat(skills): broaden plugin install support and add onboarding skill#365
Merged
feat(skills): broaden plugin install support and add onboarding skill#365
Conversation
…lidation scripts - Add Codex marketplace (.agents/plugins/marketplace.json) and per-plugin .codex-plugin/plugin.json manifests for b2c-cli, b2c, b2c-dx-mcp - Ship logo.svg in each plugin's assets/ dir (sourced from docs/public/logo.svg) - Add per-plugin README.md with install commands for Claude Code, GitHub Copilot (VS Code + CLI), and Codex - Remove b2c-experimental from the published marketplace - Add b2c-onboarding skill: IDE detection, CLI verify, setup, sandbox, first deploy, goal-routing handoff - Add optional auth-free validation scripts: * skills/b2c/skills/b2c-metadata/scripts/validate.mjs (XSD via xmllint) * skills/b2c-cli/skills/b2c-config/scripts/validate.mjs (dw.json lint) - Update README.md and docs/guide/agent-skills.md with the new install paths for Copilot (VS Code + CLI) and Codex
# Conflicts: # docs/guide/agent-skills.md
Install-oriented pages should cover how to install, not how the plugins are wired. Scrub manifest-schema and file-layout language from the agent skills doc, root README, per-plugin READMEs, and the onboarding skill so users see only the install commands they need to run. - Drop "Type" column from Available Plugins; rewrite MCP description. - Remove the "CLI does the actual work" and "drop skills into your IDE's skills directory manually" tagline language. - Collapse the Agentforce manual-install directory table into a single concise reference row in Manual Installation. - Move file-copy destination paths out of the main Other IDEs row into a Manual Installation reference sub-table. - Remove the zip-download block.
Drop the metadata XML and dw.json validation scripts plus the optional SKILL.md sections that referenced them. Use case needs more evaluation.
…ion to 1.0.0 The b2c-dx-mcp plugin ships the MCP server entry point and is only consumed by Claude Code's plugin system today. Remove it from the Codex marketplace (and from the Copilot CLI install snippets) so users don't install a dead plugin. For other clients, the MCP server can still be installed directly via the standalone MCP docs. - .agents/plugins/marketplace.json: remove b2c-dx-mcp entry - plugins/b2c-dx-mcp/.codex-plugin/ and assets/: delete - Bump b2c-cli and b2c .codex-plugin/plugin.json version from 0.0.1 to 1.0.0 - Update root README, docs/guide/agent-skills.md, b2c-onboarding SKILL.md, and plugins/b2c-dx-mcp/README.md to reflect the scope change
Introduce @salesforce/b2c-agent-plugins (at skills/package.json, private) as the changesets target for skill-content changes. Its version syncs into the plugin manifest files (.claude-plugin/marketplace.json entries for b2c-cli and b2c, plus both .codex-plugin/plugin.json files) so installed plugins see a proper version bump when skills change. Publish workflow now tracks skills-only bumps with a `b2c-agent-plugins@X.Y.Z` GitHub release tag. Skills zips are only attached to releases where the plugins package actually changed. Skills installer resolves "latest" via a hybrid: GitHub REST API (paginated, asset-filtered) with a raw.githubusercontent.com fallback when the API is rate-limited. The resolved version is cached for 1 hour to avoid redundant lookups. Zip downloads continue to go through the GitHub CDN with no API calls. - skills/package.json: new private workspace package `@salesforce/b2c-agent-plugins` - pnpm-workspace.yaml: add `skills` - scripts/sync-plugin-versions.mjs: stamps version into plugin manifests - package.json: `version` script now runs changeset version + sync - .github/workflows/changesets.yml: action uses `pnpm run version` - .github/workflows/publish.yml: adds publish_plugins gate, re-gates skills zip steps, adds release-tag fallback - packages/b2c-tooling-sdk/src/skills/github.ts: adds resolveLatestVersion() with API→raw hybrid, replaces /releases/latest usage - .claude-plugin/marketplace.json: b2c-cli and b2c entries gain `version`
Replace emoji feature icons with brand-gradient SVGs (CLI, skills, MCP) and style them with a soft brand-tinted tile. Fix Codex install instructions on both the homepage and agent-skills guide to use `codex plugin marketplace add` plus the interactive `/plugins` picker.
…start Shorten the skills intro to a concise summary instead of an exhaustive capability list. Rename installation sections to bare IDE names (Claude Code, Codex, B2C CLI, Agentforce Vibes, Other IDEs) and update the homepage cross-page anchors to match. Move Agentforce Vibes to the end of the quick-start code group, before B2C CLI.
Use a mark-only Salesforce cloud logo (no wordmark) in the top nav so it reads cleanly beside the site title. Align the homepage meta description with the hero tagline for consistent SEO copy.
clavery
requested review from
patricksullivansf,
wei-liu-sf and
yhsieh1
as code owners
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Improves install coverage and ergonomics for the existing B2C skills plugins (
b2c-cli,b2c,b2c-dx-mcp). No new plugin system — just wider client support, a new onboarding skill, and lighter install docs.b2c-onboardingskill in theb2cplugin: IDE-agnostic first-time setup walkthrough (verify CLI →dw.jsonsetup → sandbox → first cartridge deploy → hand off to the skill matching the user's goal).README.mdon each plugin source dir with install commands for every supported client.b2c-experimentalfrom the public marketplace (not advertised).Post Merge Test plan
claude plugin marketplace add SalesforceCommerceCloud/b2c-developer-toolingstill works and lists three plugins.copilot plugin marketplace add SalesforceCommerceCloud/b2c-developer-toolingworks and lists three plugins.SalesforceCommerceCloud/b2c-developer-toolinginstalls plugins.b2c setup skillsstill works for Cursor, Windsurf, Agentforce Vibes, OpenCode, VS Code, Codex, manual.b2c-onboardingskill triggers on "help me get started with B2C Commerce" and delegates correctly tob2c-config,b2c-sandbox, andb2c-code.docs/guide/agent-skills.mdcleanly; install path for each client is present.