skill frontmatter refinement

clavery · clavery · commit fa49a23efabb · 2026-01-31T10:36:05.000-05:00
diff --git a/skills/b2c-cli/skills/b2c-code/SKILL.md b/skills/b2c-cli/skills/b2c-code/SKILL.md
@@ -1,11 +1,13 @@
 ---
 name: b2c-code
-description: Deploy and manage code versions on B2C Commerce instances. Use when uploading cartridges, activating code versions, watching for file changes during development, or syncing local code to sandbox.
+description: Deploy and manage code versions/cartridges on B2C Commerce instances/sandboxes with the b2c cli. Use when uploading cartridges, activating code versions, watching for file changes during development and CI/CD.
 ---
 
 # B2C Code Skill
 
-Use the `b2c` CLI plugin to deploy and manage code versions on Salesforce B2C Commerce instances.
+Use the `b2c` CLI to deploy and manage code versions on Salesforce B2C Commerce instances.
+
+> **Tip:** If `b2c` is not installed globally, use `npx @salesforce/b2c-cli` instead (e.g., `npx @salesforce/b2c-cli code deploy`).
 
 ## Examples
 
diff --git a/skills/b2c-cli/skills/b2c-config/SKILL.md b/skills/b2c-cli/skills/b2c-config/SKILL.md
@@ -1,12 +1,14 @@
 ---
 name: b2c-config
-description: View and debug B2C CLI configuration and understand where credentials come from. Use when authentication fails, connection errors occur, wrong instance is used, or you need to verify dw.json settings, environment variables (SFCC_*), or OAuth credentials are loaded correctly.
+description: View and debug b2c CLI configuration and understand where credentials come from. Use when authentication fails, connection errors occur, wrong instance is used, or you need to verify dw.json settings, or OAuth credentials are loaded correctly.
 ---
 
 # B2C Config Skill
 
 Use the `b2c setup config` command to view the resolved configuration and understand where each value comes from. This is essential for debugging configuration issues and verifying that the CLI is using the correct settings.
 
+> **Tip:** If `b2c` is not installed globally, use `npx @salesforce/b2c-cli` instead (e.g., `npx @salesforce/b2c-cli setup config`).
+
 ## When to Use
 
 Use `b2c setup config` when you need to:
diff --git a/skills/b2c-cli/skills/b2c-docs/SKILL.md b/skills/b2c-cli/skills/b2c-docs/SKILL.md
@@ -1,12 +1,14 @@
 ---
 name: b2c-docs
-description: Search and read B2C Commerce Script API documentation and XSD schemas. Use when writing B2C scripts, looking up classes for the SFCC/Demandware/B2C Commerce script API, answering "how do I" questions about generating URLs, querying products, processing orders, services, or any dw.* API task. Also use for import/export XML format reference. Use to verify class methods, properties, and usage.
+description: Search and read B2C Commerce (SFCC/Demandware) Script API documentation and XSD schemas with the b2c cli. Use when writing B2C scripts, looking up classes for the SFCC/Demandware/B2C Commerce script API, answering "how do I" questions about URLs, products, orders. Also use for import/export XML format (XSD) reference. Use to verify class methods, properties, and usage in the dw.* API namespace
 ---
 
 # B2C Docs Skill
 
 Use the `b2c` CLI to search and read bundled Script API documentation and XSD schemas for Salesforce B2C Commerce.
 
+> **Tip:** If `b2c` is not installed globally, use `npx @salesforce/b2c-cli` instead (e.g., `npx @salesforce/b2c-cli docs search ProductMgr`).
+
 ## Examples
 
 ### Search Documentation
diff --git a/skills/b2c-cli/skills/b2c-ecdn/SKILL.md b/skills/b2c-cli/skills/b2c-ecdn/SKILL.md
@@ -1,12 +1,14 @@
 ---
 name: b2c-ecdn
-description: Manage eCDN (embedded Content Delivery Network) settings. Use when purging cache, configuring WAF rules, managing SSL certificates, setting rate limits, or creating CDN zones for storefronts.
+description: Manage b2c/sfcc/demandware eCDN (embedded Content Delivery Network) settings
 ---
 
 # B2C eCDN Skill
 
 Use the `b2c` CLI plugin to manage eCDN (embedded Content Delivery Network) zones, certificates, security settings, and more.
 
+> **Tip:** If `b2c` is not installed globally, use `npx @salesforce/b2c-cli` instead (e.g., `npx @salesforce/b2c-cli ecdn zones list`).
+
 ## Prerequisites
 
 - OAuth credentials with `sfcc.cdn-zones` scope (read operations)
diff --git a/skills/b2c-cli/skills/b2c-job/SKILL.md b/skills/b2c-cli/skills/b2c-job/SKILL.md
@@ -1,12 +1,14 @@
 ---
 name: b2c-job
-description: Run and monitor existing jobs, import/export site archives (IMPEX). Use when executing batch jobs, importing site data, running search indexing, checking job status, or viewing job logs. For creating new job code, use b2c-custom-job-steps instead.
+description: Run and monitor existing (B2C/demandware/SFCC) jobs using the b2c cli, import/export site archives (IMPEX). Use when executing batch jobs, importing site data, running search indexing, checking job status, or viewing job logs. For creating new jobs, use b2c-custom-job-steps skill instead.
 ---
 
 # B2C Job Skill
 
 Use the `b2c` CLI plugin to **run existing jobs** and import/export site archives on Salesforce B2C Commerce instances.
 
+> **Tip:** If `b2c` is not installed globally, use `npx @salesforce/b2c-cli` instead (e.g., `npx @salesforce/b2c-cli job run`).
+
 > **Creating a new job?** If you need to write custom job step code (batch processing, scheduled tasks, data sync), use the `b2c:b2c-custom-job-steps` skill instead.
 
 ## Examples
diff --git a/skills/b2c-cli/skills/b2c-logs/SKILL.md b/skills/b2c-cli/skills/b2c-logs/SKILL.md
@@ -1,12 +1,14 @@
 ---
 name: b2c-logs
-description: Retrieve and monitor log files from B2C Commerce instances. Use when fetching recent errors, searching log entries, filtering by level/time, or real-time tailing. The `logs get` command is optimized for coding agents with JSON output.
+description: Retrieve and monitor log files from B2C Commerce (SFCC/demandware) instances. Use when fetching recent errors, searching log entries, filtering by level/time, or real-time tailing. The `logs get` command is optimized for filtered retrieval with JSON output.
 ---
 
 # B2C Logs Skill
 
 Use the `b2c` CLI to retrieve and monitor log files on Salesforce B2C Commerce instances. The `logs get` command is designed for agent-friendly, non-interactive log retrieval with structured JSON output.
 
+> **Tip:** If `b2c` is not installed globally, use `npx @salesforce/b2c-cli` instead (e.g., `npx @salesforce/b2c-cli logs get`).
+
 ## Agent-Friendly Log Retrieval
 
 The `logs get` command is optimized for coding agents:
diff --git a/skills/b2c-cli/skills/b2c-mrt/SKILL.md b/skills/b2c-cli/skills/b2c-mrt/SKILL.md
@@ -1,12 +1,14 @@
 ---
 name: b2c-mrt
-description: Deploy and manage Managed Runtime (MRT) PWA storefronts. Use when deploying bundles, managing environments, setting environment variables, configuring redirects, or working with CDN for PWA Kit projects.
+description: Deploy and manage (B2C/SFCC/Demandware) Managed Runtime (MRT) storefronts using the b2c cli. Use when deploying bundles, managing environments, setting environment variables, configuring redirects, or working with MRT CDN
 ---
 
 # B2C MRT Skill
 
 Use the `b2c` CLI to manage Managed Runtime (MRT) projects, environments, bundles, and deployments for PWA Kit storefronts.
 
+> **Tip:** If `b2c` is not installed globally, use `npx @salesforce/b2c-cli` instead (e.g., `npx @salesforce/b2c-cli mrt bundle deploy`).
+
 ## Command Structure
 
 ```
diff --git a/skills/b2c-cli/skills/b2c-ods/SKILL.md b/skills/b2c-cli/skills/b2c-ods/SKILL.md
@@ -1,12 +1,16 @@
 ---
 name: b2c-ods
-description: Create and manage on-demand sandboxes (ODS). Use when provisioning development instances, starting/stopping sandboxes, checking sandbox status, or managing sandbox lifecycle. Only create or delete sandboxes when explicitly requested.
+description: Create and manage (B2C/SFCC/Demandware) on-demand sandboxes (ODS) with the b2c cli. Use when provisioning development instances, starting/stopping sandboxes, checking sandbox status, or managing sandbox lifecycle.
 ---
 
 # B2C ODS Skill
 
+Only create or delete sandboxes when explicitly requested. Always confirm destructive actions.
+
 Use the `b2c` CLI plugin to manage Salesforce B2C Commerce On-demand sandboxes (ODS). Only create or delete a sandbox if explicitly asked as this may be a billable or destructible action.
 
+> **Tip:** If `b2c` is not installed globally, use `npx @salesforce/b2c-cli` instead (e.g., `npx @salesforce/b2c-cli ods list`).
+
 ## Sandbox ID Formats
 
 Commands that operate on a specific sandbox accept two ID formats:
diff --git a/skills/b2c-cli/skills/b2c-scapi-custom/SKILL.md b/skills/b2c-cli/skills/b2c-scapi-custom/SKILL.md
@@ -1,12 +1,14 @@
 ---
 name: b2c-scapi-custom
-description: Check Custom SCAPI endpoint registration status. Use when verifying custom API deployment, debugging "endpoint not found" errors, or checking if code activation registered new APIs. For creating new custom APIs, use b2c-custom-api-development instead.
+description: Check Custom SCAPI (B2C/SFCC/Demandware) endpoint registration status with the b2c cli. Use when verifying custom API deployment, debugging "endpoint not found" errors, or checking if code activation registered new APIs. For creating new custom APIs, use b2c-custom-api-development skill instead.
 ---
 
 # B2C SCAPI Custom APIs Skill
 
 Use the `b2c` CLI plugin to manage SCAPI Custom API endpoints and check their registration status.
 
+> **Tip:** If `b2c` is not installed globally, use `npx @salesforce/b2c-cli` instead (e.g., `npx @salesforce/b2c-cli scapi custom status`).
+
 ## Required: Tenant ID
 
 The `--tenant-id` flag is **required** for all commands. The tenant ID identifies your B2C Commerce instance.
diff --git a/skills/b2c-cli/skills/b2c-scapi-schemas/SKILL.md b/skills/b2c-cli/skills/b2c-scapi-schemas/SKILL.md
@@ -1,12 +1,14 @@
 ---
 name: b2c-scapi-schemas
-description: Browse and retrieve SCAPI OpenAPI schemas. Use when exploring available SCAPI endpoints, checking API request/response formats, understanding SCAPI data models, or finding the right API for a task.
+description: Browse and retrieve (B2C/SFCC/Demandware) SCAPI OpenAPI schemas with the b2c cli. Use when exploring available SCAPI endpoints, checking API request/response formats, understanding SCAPI data models, or finding the right API for a task.
 ---
 
 # B2C SCAPI Schemas Skill
 
 Use the `b2c` CLI plugin to browse and retrieve SCAPI OpenAPI schema specifications.
 
+> **Tip:** If `b2c` is not installed globally, use `npx @salesforce/b2c-cli` instead (e.g., `npx @salesforce/b2c-cli scapi schemas list`).
+
 ## Required: Tenant ID
 
 The `--tenant-id` flag is **required** for all commands. The tenant ID identifies your B2C Commerce instance.
diff --git a/skills/b2c-cli/skills/b2c-site-import-export/SKILL.md b/skills/b2c-cli/skills/b2c-site-import-export/SKILL.md
@@ -1,12 +1,14 @@
 ---
 name: b2c-site-import-export
-description: Work with site archive structure and metadata XML patterns. Use when adding custom attributes, system object extensions, site preferences, or understanding import/export XML schemas. Covers directory structure and XML file formats for site archives.
+description: Work with (B2C/SFCC/Demandware) site archive import archives and metadata XML patterns with the b2c cli. Use when adding custom attributes, system object extensions, site preferences, or understanding import/export XML schemas. Covers directory structure and XML file formats for site archives.
 ---
 
 # Site Import/Export Skill
 
 Use the `b2c` CLI plugin to import and export site archives on Salesforce B2C Commerce instances.
 
+> **Tip:** If `b2c` is not installed globally, use `npx @salesforce/b2c-cli` instead (e.g., `npx @salesforce/b2c-cli job import`).
+
 ## Import Commands
 
 ### Import Local Directory
diff --git a/skills/b2c-cli/skills/b2c-sites/SKILL.md b/skills/b2c-cli/skills/b2c-sites/SKILL.md
@@ -1,12 +1,14 @@
 ---
 name: b2c-sites
-description: List and inspect storefront sites on B2C Commerce instances. Use when finding site IDs, checking site configuration, or listing available sites. Helpful for determining site context when running other commands.
+description: List and inspect storefront sites on B2C Commerce (SFCC/Demandware) instances with the b2c cli. Use when finding site IDs, checking site configuration, or listing available sites. Helpful for determining site context when running other commands.
 ---
 
 # B2C Sites Skill
 
 Use the `b2c` CLI plugin to list and inspect storefront sites on Salesforce B2C Commerce instances.
 
+> **Tip:** If `b2c` is not installed globally, use `npx @salesforce/b2c-cli` instead (e.g., `npx @salesforce/b2c-cli sites list`).
+
 ## Examples
 
 ### List Sites
diff --git a/skills/b2c-cli/skills/b2c-slas/SKILL.md b/skills/b2c-cli/skills/b2c-slas/SKILL.md
@@ -1,12 +1,14 @@
 ---
 name: b2c-slas
-description: Manage SLAS (Shopper Login and API Access Service) clients. Use when configuring shopper authentication, creating API clients for PWA/headless, managing OAuth scopes (including custom scopes like c_loyalty), or debugging token issues.
+description: Manage SLAS (Shopper Login and API Access Service) clients for B2C Commerce (SFCC/Demandware) with the b2c cli. Use when configuring shopper authentication, creating API clients for PWA/headless, managing OAuth scopes (including custom scopes like c_loyalty), or debugging token issues.
 ---
 
 # B2C SLAS Skill
 
 Use the `b2c` CLI plugin to manage SLAS (Shopper Login and API Access Service) API clients and credentials.
 
+> **Tip:** If `b2c` is not installed globally, use `npx @salesforce/b2c-cli` instead (e.g., `npx @salesforce/b2c-cli slas client list`).
+
 ## When to Use
 
 Common scenarios requiring SLAS client management:
diff --git a/skills/b2c-cli/skills/b2c-webdav/SKILL.md b/skills/b2c-cli/skills/b2c-webdav/SKILL.md
@@ -1,12 +1,14 @@
 ---
 name: b2c-webdav
-description: List, upload, download, and manage files on B2C Commerce instances via WebDAV. Use when reading error logs (customerror, debug), downloading job logs, uploading to IMPEX directories, or managing files in cartridges/catalogs/static folders.
+description: List, upload, download, and manage files on B2C Commerce (SFCC/Demandware) instances via WebDAV. Use when reading error logs (customerror, debug), downloading job logs, uploading to IMPEX directories, or managing files in cartridges/catalogs/static folders.
 ---
 
 # B2C WebDAV Skill
 
 Use the `b2c` CLI plugin to perform WebDAV file operations on Salesforce B2C Commerce instances. This includes listing files, uploading, downloading, and managing files across different WebDAV roots.
 
+> **Tip:** If `b2c` is not installed globally, use `npx @salesforce/b2c-cli` instead (e.g., `npx @salesforce/b2c-cli webdav ls`).
+
 ## WebDAV Roots
 
 The `--root` flag specifies the WebDAV directory:
diff --git a/skills/b2c/skills/b2c-custom-api-development/SKILL.md b/skills/b2c/skills/b2c-custom-api-development/SKILL.md
@@ -7,6 +7,8 @@ description: Develop Custom SCAPI endpoints for B2C Commerce. Use when creating
 
 This skill guides you through developing Custom APIs for Salesforce B2C Commerce. Custom APIs let you expose custom script code as REST endpoints under the SCAPI framework.
 
+> **Tip:** If `b2c` CLI is not installed globally, use `npx @salesforce/b2c-cli` instead (e.g., `npx @salesforce/b2c-cli code deploy`).
+
 ## Overview
 
 A Custom API URL has this structure:
