skill clarity after manual testing for e2e scenario

Author: clavery

plugins/b2c-cli/skills/b2c-code/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: b2c-code
-description: Salesforce B2C Commerce code version deployment and management Skill
+description: Using the b2c CLI for code version deployment and management
 ---
 
 # B2C Code Skill

plugins/b2c-cli/skills/b2c-docs/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: b2c-docs
-description: Search and read Salesforce B2C Commerce Script API documentation and XSD schemas
+description: Using the b2c CLI to search and read Script API documentation and XSD schemas
 ---
 
 # B2C Docs Skill

plugins/b2c-cli/skills/b2c-job/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: b2c-job
-description: Salesforce B2C Commerce job execution and site archive import/export (IMPEX) Skill
+description: Using the b2c CLI for job execution and site archive import/export (IMPEX)
 ---
 
 # B2C Job Skill
@@ -44,6 +44,8 @@ Note: `--body` and `-P` are mutually exclusive.
 
 ### Import Site Archives
 
+The `job import` command automatically waits for the import job to complete before returning.
+
 ```bash
 # import a local directory as a site archive
 b2c job import ./my-site-data

plugins/b2c-cli/skills/b2c-mrt/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: b2c-mrt
-description: Salesforce B2C Commerce Managed Runtime (MRT) project and deployment management Skill
+description: Using the b2c CLI for Managed Runtime (MRT) project and deployment management
 ---
 
 # B2C MRT Skill

plugins/b2c-cli/skills/b2c-ods/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: b2c-ods
-description: Salesforce B2C Commerce On-demand sandbox (ODS) management Skill
+description: Using the b2c CLI for on-demand sandbox (ODS) management
 ---
 
 # B2C ODS Skill

plugins/b2c-cli/skills/b2c-scapi-custom/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: b2c-scapi-custom
-description: Salesforce B2C Commerce Custom API endpoint management Skill
+description: Using the b2c CLI for Custom SCAPI endpoint management
 ---
 
 # B2C SCAPI Custom APIs Skill

plugins/b2c-cli/skills/b2c-sites/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: b2c-sites
-description: Salesforce B2C Commerce storefront sites listing and inspection Skill
+description: Using the b2c CLI for storefront sites listing and inspection
 ---
 
 # B2C Sites Skill

plugins/b2c-cli/skills/b2c-slas/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: b2c-slas
-description: Salesforce B2C Commerce SLAS (Shopper Login and API Access Service) client management Skill
+description: Using the b2c CLI for SLAS (Shopper Login and API Access Service) client management
 ---
 
 # B2C SLAS Skill

plugins/b2c-cli/skills/b2c-webdav/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: b2c-webdav
-description: Salesforce B2C Commerce WebDAV file operations (listing, upload, download, logs) Skill
+description: Using the b2c CLI for WebDAV file operations (listing, upload, download, logs)
 ---
 
 # B2C WebDAV Skill

plugins/b2c/skills/b2c-custom-job-steps/SKILL.md

@@ -343,6 +343,10 @@ exports.afterStep = function (success, parameters, stepExecution) {
 5. **Handle errors gracefully** - return proper Status objects
 6. **Don't rely on transactional=true** - use `Transaction.wrap()` for control
 
+## Related Skills
+
+- [b2c:b2c-webservices](../b2c-webservices/SKILL.md) - When job steps need to call external HTTP services or APIs, use the webservices skill for service configuration and HTTP client patterns
+
 ## Detailed Reference
 
 - [Task-Oriented Steps](references/TASK-ORIENTED.md) - Full task step patterns