b2c-cli skill tweaks

clavery · clavery · commit 09713c6ff134 · 2026-02-17T10:07:49.000-05:00
diff --git a/skills/b2c-cli/skills/b2c-cip/SKILL.md b/skills/b2c-cli/skills/b2c-cip/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: b2c-cip
-description: Run Commerce Intelligence Platform (CIP/CCAC) analytics reports, metadata discovery, and SQL queries with the b2c cli. Use when users ask for sales/search/payment analytics, KPI validation, table discovery, schema inspection, report exports, or custom SQL against B2C Commerce Intelligence data.
+description: Run Commerce Intelligence Platform (CIP/CCAC) analytics reports, metadata discovery, and SQL queries with the b2c cli. Always reference when using the CLI to run analytics reports, query Commerce Intelligence data, discover CIP tables, or export KPI metrics. Also use when users ask about sales, search, or payment analytics.
 ---
 
 # B2C CIP Skill
diff --git a/skills/b2c-cli/skills/b2c-code/SKILL.md b/skills/b2c-cli/skills/b2c-code/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: b2c-code
-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.
+description: Deploy and manage code versions/cartridges on B2C Commerce instances/sandboxes with the b2c cli. Always reference when using the CLI to upload cartridges, deploy code, activate code versions, manage code versions, or watch for file changes during development.
 ---
 
 # B2C Code Skill
diff --git a/skills/b2c-cli/skills/b2c-config/SKILL.md b/skills/b2c-cli/skills/b2c-config/SKILL.md
@@ -1,6 +1,6 @@
 ---
 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, or OAuth credentials are loaded correctly.
+description: View and debug b2c CLI configuration and understand where credentials come from. Always reference when using the CLI to inspect configuration, manage instances, retrieve OAuth tokens, or set up IDE integration. Also use when authentication fails, connection errors occur, or the wrong instance is being used.
 ---
 
 # B2C Config Skill
diff --git a/skills/b2c-cli/skills/b2c-content/SKILL.md b/skills/b2c-cli/skills/b2c-content/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: b2c-content
-description: Export and list Page Designer pages from B2C Commerce content libraries. Use when exporting pages with components and assets, discovering page IDs, or working with content library XML.
+description: Export and list Page Designer pages from B2C Commerce content libraries. Always reference when using the CLI to export or list Page Designer content, discover page IDs, or work with content library assets.
 ---
 
 # B2C Content Skill
diff --git a/skills/b2c-cli/skills/b2c-docs/SKILL.md b/skills/b2c-cli/skills/b2c-docs/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: b2c-docs
-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
+description: Search and read B2C Commerce (SFCC/Demandware) Script API documentation and XSD schemas with the b2c cli. Always reference when using the CLI to search or read Script API documentation, look up dw.* classes, or browse XSD schemas. Also use when writing B2C scripts, answering "how do I" questions about URLs/products/orders, or verifying class methods and properties.
 ---
 
 # B2C Docs Skill
diff --git a/skills/b2c-cli/skills/b2c-ecdn/SKILL.md b/skills/b2c-cli/skills/b2c-ecdn/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: b2c-ecdn
-description: Manage B2C Commerce eCDN (embedded CDN) settings with the b2c cli. Use when purging cache, configuring WAF rules, managing SSL certificates, setting rate limits, or creating CDN zones.
+description: Manage B2C Commerce eCDN (embedded CDN) settings with the b2c cli. Always reference when using the CLI to purge CDN cache, configure WAF rules, manage SSL certificates, set rate limits, manage firewall rules, or create CDN zones.
 ---
 
 # B2C eCDN Skill
diff --git a/skills/b2c-cli/skills/b2c-job/SKILL.md b/skills/b2c-cli/skills/b2c-job/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: b2c-job
-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.
+description: Run and monitor existing (B2C/demandware/SFCC) jobs using the b2c cli, import/export site archives (IMPEX). Always reference when using the CLI to run jobs, import or export site archives, check job execution status, or trigger search indexing. For creating new jobs, use b2c-custom-job-steps skill instead.
 ---
 
 # B2C Job Skill
diff --git a/skills/b2c-cli/skills/b2c-logs/SKILL.md b/skills/b2c-cli/skills/b2c-logs/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: b2c-logs
-description: Retrieve or monitor log from B2C Commerce instances with the b2c cli. When a user reports something like 'throwing an error,' 'broken,' or 'not working,' use this in addition to searching code. Use to fetch recent errors, searching log entries, filtering by level/time, or real-time tailing. Use when investigating issues with controllers, script APIs, custom API backend, jobs, or other SFCC server-side issues.
+description: Retrieve or monitor logs from B2C Commerce instances with the b2c cli. Always reference when using the CLI to fetch logs, search log entries, filter by level/time, or tail logs in real-time. Also use when a user reports errors, broken functionality, or issues with controllers, script APIs, custom API backends, jobs, or other SFCC server-side components.
 ---
 
 # B2C Logs Skill
diff --git a/skills/b2c-cli/skills/b2c-mrt/SKILL.md b/skills/b2c-cli/skills/b2c-mrt/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: b2c-mrt
-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
+description: Deploy and manage (B2C/SFCC/Demandware) Managed Runtime (MRT) storefronts using the b2c cli. Always reference when using the CLI to deploy MRT bundles, manage MRT environments, set environment variables, configure redirects, or manage MRT projects and organizations.
 ---
 
 # B2C MRT Skill
diff --git a/skills/b2c-cli/skills/b2c-sandbox/SKILL.md b/skills/b2c-cli/skills/b2c-sandbox/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: b2c-sandbox
-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.
+description: Create and manage (B2C/SFCC/Demandware) on-demand sandboxes (ODS) with the b2c cli. Always reference when using the CLI to create, start, stop, restart, delete, or list on-demand sandboxes (ODS) and development instances.
 ---
 
 # B2C Sandbox Skill
diff --git a/skills/b2c-cli/skills/b2c-scapi-custom/SKILL.md b/skills/b2c-cli/skills/b2c-scapi-custom/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: b2c-scapi-custom
-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.
+description: Check Custom SCAPI (B2C/SFCC/Demandware) endpoint registration status with the b2c cli. Always reference when using the CLI to check custom API endpoint status, verify custom API deployment, or debug "endpoint not found" errors. For creating new custom APIs, use b2c-custom-api-development skill instead.
 ---
 
 # B2C SCAPI Custom APIs Skill
diff --git a/skills/b2c-cli/skills/b2c-scapi-schemas/SKILL.md b/skills/b2c-cli/skills/b2c-scapi-schemas/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: b2c-scapi-schemas
-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.
+description: Browse and retrieve (B2C/SFCC/Demandware) SCAPI OpenAPI schemas with the b2c cli. Always reference when using the CLI to browse SCAPI schemas, check API request/response formats, explore available endpoints, or understand SCAPI data models.
 ---
 
 # B2C SCAPI Schemas Skill
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,6 +1,6 @@
 ---
 name: b2c-site-import-export
-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.
+description: Work with (B2C/SFCC/Demandware) site archive import archives and metadata XML patterns with the b2c cli. Always reference when using the CLI to work with site archive imports, add custom attributes, create system object extensions, configure site preferences, or understand import/export XML schemas.
 ---
 
 # Site Import/Export Skill
diff --git a/skills/b2c-cli/skills/b2c-sites/SKILL.md b/skills/b2c-cli/skills/b2c-sites/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: b2c-sites
-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.
+description: List and inspect storefront sites on B2C Commerce (SFCC/Demandware) instances with the b2c cli. Always reference when using the CLI to list storefront sites, find site IDs, or check site configuration.
 ---
 
 # B2C Sites Skill
diff --git a/skills/b2c-cli/skills/b2c-slas/SKILL.md b/skills/b2c-cli/skills/b2c-slas/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: b2c-slas
-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. SLAS is for shopper (customer) authentication, not admin APIs.
+description: Manage SLAS (Shopper Login and API Access Service) clients for B2C Commerce (SFCC/Demandware) with the b2c cli. Always reference when using the CLI to create, update, list, or delete SLAS clients, manage shopper OAuth scopes (including custom scopes like c_loyalty), or configure shopper authentication for PWA/headless. SLAS is for shopper (customer) authentication, not admin APIs.
 ---
 
 # B2C SLAS Skill
diff --git a/skills/b2c-cli/skills/b2c-webdav/SKILL.md b/skills/b2c-cli/skills/b2c-webdav/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: b2c-webdav
-description: List, upload, download, and manage files on B2C Commerce instances via WebDAV with the b2c cli. Use when uploading to IMPEX directories, downloading files, managing files in cartridges/catalogs/static/temp folders, creating directories, or zipping/unzipping remote files. For log exploration and tailing, use b2c-logs instead.
+description: List, upload, download, and manage files on B2C Commerce instances via WebDAV with the b2c cli. Always reference when using the CLI to upload or download files via WebDAV, manage IMPEX directories, create remote directories, or zip/unzip remote files. For log exploration and tailing, use b2c-logs instead.
 ---
 
 # B2C WebDAV Skill
