skill nits

Author: clavery

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

@@ -1,11 +1,14 @@
 ---
 name: b2c-job
-description: Using the b2c CLI for job execution and site archive import/export (IMPEX)
+description: Using the b2c CLI to run and monitor existing jobs, import/export site archives (IMPEX). Use this for executing jobs, not creating new job step code.
+keywords: [run job, execute job, import data, export data, site archive, IMPEX, job status, job log]
 ---
 
 # B2C Job Skill
 
-Use the `b2c` CLI plugin to run jobs and import/export site archives on Salesforce B2C Commerce instances.
+Use the `b2c` CLI plugin to **run existing jobs** and import/export site archives on Salesforce B2C Commerce instances.
+
+> **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
 
@@ -90,3 +93,8 @@ b2c job wait <execution-id>
 ### More Commands
 
 See `b2c job --help` for a full list of available commands and options in the `job` topic.
+
+## Related Skills
+
+- `b2c:b2c-custom-job-steps` - For **creating** new custom job steps (batch processing scripts, scheduled tasks, data sync jobs)
+- `b2c-cli:b2c-site-import-export` - For site archive structure and metadata XML patterns

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

@@ -1,11 +1,22 @@
 ---
 name: b2c-custom-job-steps
-description: Guide for creating custom job steps in Salesforce B2C Commerce
+description: Guide for creating custom job steps for batch processing, imports, exports, scheduled tasks, and data sync in Salesforce B2C Commerce. Use this when writing new job code.
+keywords: [create job, new job, batch job, scheduled job, import job, export job, data sync, bulk processing, steptypes.json, job step code]
 ---
 
 # Custom Job Steps Skill
 
-This skill guides you through creating custom job steps for Salesforce B2C Commerce batch processing.
+This skill guides you through **creating new custom job steps** for Salesforce B2C Commerce batch processing.
+
+> **Running an existing job?** If you need to execute jobs or import site archives via CLI, use the `b2c-cli:b2c-job` skill instead.
+
+## When to Use This Skill
+
+- Creating a **new scheduled job** for batch processing
+- Building a **data import job** (customers, products, orders)
+- Building a **data export job** (reports, feeds, sync)
+- Implementing **data sync** between systems
+- Creating **cleanup or maintenance tasks**
 
 ## Overview
 
@@ -345,7 +356,8 @@ exports.afterStep = function (success, parameters, stepExecution) {
 
 ## 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
+- `b2c-cli:b2c-job` - For **running** existing jobs and importing site archives via CLI
+- `b2c:b2c-webservices` - When job steps need to call external HTTP services or APIs, use the webservices skill for service configuration and HTTP client patterns
 
 ## Detailed Reference