fix: correct inaccurate flags and commands in CLI skill documentation

- b2c-ecdn: fix zones create flags, remove nonexistent cache purge
  --purge-everything and certificates get command
- b2c-users-roles: fix clients create --display-name to --name, add
  required --password and --orgs flags, add --current/--new to
  clients password
- b2c-am: fix --expand syntax to use comma-separated values
- b2c-job: add missing job log command, expand search and wait docs

Author: clavery

.changeset/fix-skill-documentation-accuracy.md

@@ -0,0 +1,5 @@
+---
+'@salesforce/b2c-cli': patch
+---
+
+Fix inaccurate flags and commands in CLI skill documentation for job, ecdn, am, and users-roles skills

skills/b2c-cli/skills/b2c-am/SKILL.md

@@ -48,7 +48,7 @@ b2c am clients list --json
 b2c am clients get <api-client-id>
 
 # with expanded organizations and roles
-b2c am clients get <api-client-id> --expand organizations --expand roles
+b2c am clients get <api-client-id> --expand organizations,roles
 ```
 
 ### Create Client

skills/b2c-cli/skills/b2c-ecdn/SKILL.md

@@ -31,7 +31,7 @@ b2c ecdn zones list --tenant-id zzxy_prd --json
 
 ```bash
 # create a new storefront zone
-b2c ecdn zones create --tenant-id zzxy_prd --storefront-hostname www.example.com --origin-hostname origin.example.com
+b2c ecdn zones create --tenant-id zzxy_prd --domain-name example.com
 ```
 
 ### Purge Cache
@@ -42,9 +42,6 @@ b2c ecdn cache purge --tenant-id zzxy_prd --zone my-zone --path /products --path
 
 # purge by cache tags
 b2c ecdn cache purge --tenant-id zzxy_prd --zone my-zone --tag product-123 --tag category-456
-
-# purge everything
-b2c ecdn cache purge --tenant-id zzxy_prd --zone my-zone --purge-everything
 ```
 
 ### Manage Certificates
@@ -56,9 +53,6 @@ b2c ecdn certificates list --tenant-id zzxy_prd --zone my-zone
 # add a new certificate
 b2c ecdn certificates add --tenant-id zzxy_prd --zone my-zone --hostname www.example.com --certificate-file ./cert.pem --private-key-file ./key.pem
 
-# get certificate details
-b2c ecdn certificates get --tenant-id zzxy_prd --zone my-zone --certificate-id abc123
-
 # validate a custom hostname
 b2c ecdn certificates validate --tenant-id zzxy_prd --zone my-zone --certificate-id abc123
 ```

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

@@ -148,12 +148,38 @@ b2c job export --global-data meta_data --timeout 600
 
 For full control over the export configuration (including `catalog_static_resources`, `library_static_resources`, and `customer_lists`), use `--data-units` with a JSON string matching the `ExportDataUnitsConfiguration` shape.
 
+### View Job Logs
+
+```bash
+# get the log from the most recent execution of a job
+b2c job log my-custom-job
+
+# get the log from the most recent failed execution
+b2c job log my-custom-job --failed
+
+# get the log from a specific execution
+b2c job log my-custom-job abc123-def456
+```
+
 ### Search Job Executions
 
 ```bash
-# search for job executions
+# search for recent job executions
 b2c job search
 
+# filter by job ID
+b2c job search --job-id my-custom-job
+
+# filter by status
+b2c job search --status ERROR
+b2c job search --status RUNNING,PENDING
+
+# control result count and pagination
+b2c job search --count 50 --start 0
+
+# sort results
+b2c job search --sort-by start_time --sort-order desc
+
 # search with JSON output
 b2c job search --json
 ```
@@ -163,11 +189,13 @@ b2c job search --json
 ```bash
 # wait for a specific job execution to complete (requires both job ID and execution ID)
 b2c job wait <job-id> <execution-id>
-```
 
-### More Commands
+# wait with a timeout
+b2c job wait <job-id> <execution-id> --timeout 600
 
-See `b2c job --help` for a full list of available commands and options in the `job` topic.
+# wait with a custom polling interval
+b2c job wait <job-id> <execution-id> --poll-interval 5
+```
 
 ## Related Skills
 

skills/b2c-cli/skills/b2c-users-roles/SKILL.md

@@ -78,10 +78,10 @@ b2c am orgs list
 b2c am clients list
 
 # create an API client
-b2c am clients create --display-name "My Client" --org MyOrg
+b2c am clients create --name "My Client" --orgs MyOrg --password "securePassword123"
 
-# reset API client password
-b2c am clients password my-client-id
+# change API client password
+b2c am clients password my-client-id --current "oldPass" --new "newPass123"
 ```
 
 ## Business Manager Roles