skill nits

Author: clavery

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

@@ -7,6 +7,14 @@ description: Using the b2c CLI for SLAS (Shopper Login and API Access Service) c
 
 Use the `b2c` CLI plugin to manage SLAS (Shopper Login and API Access Service) API clients and credentials.
 
+## When to Use This Skill
+
+Common scenarios requiring SLAS client management:
+
+- **Testing Custom APIs**: Create a client with custom scopes (e.g., `c_loyalty`) to test your Custom API endpoints
+- **PWA/Headless Development**: Configure clients for composable storefronts
+- **Integration Testing**: Create dedicated test clients with specific scope sets
+
 ## Examples
 
 ### List SLAS Clients
@@ -47,6 +55,44 @@ b2c slas client create --tenant-id abcd_123 --channels RefArch --default-scopes
 
 Note: By default, the tenant is automatically created if it doesn't exist.
 
+### Create Client for Custom API Testing
+
+When testing a Custom API that requires custom scopes:
+
+```bash
+# Create a private client with custom scope for testing
+# Replace c_my_scope with your API's custom scope from schema.yaml
+b2c slas client create \
+  --tenant-id zzpq_013 \
+  --channels RefArch \
+  --default-scopes \
+  --scopes "c_my_scope" \
+  --redirect-uri http://localhost:3000/callback \
+  --json
+
+# Output includes client_id and client_secret - save these for token requests
+```
+
+**Important:** The custom scope in your SLAS client must match the scope defined in your Custom API's `schema.yaml` security section.
+
+### Get a Token for Testing
+
+After creating a SLAS client, obtain a token for API testing:
+
+```bash
+# Set credentials from client creation output
+SHORTCODE="zzpq"
+ORG="f_ecom_zzpq_013"
+CLIENT_ID="your-client-id"
+CLIENT_SECRET="your-client-secret"
+SITE="RefArch"
+
+# Get access token
+curl -s "https://$SHORTCODE.api.commercecloud.salesforce.com/shopper/auth/v1/organizations/$ORG/oauth2/token" \
+  -u "$CLIENT_ID:$CLIENT_SECRET" \
+  -d "grant_type=client_credentials&channel_id=$SITE"
+```
+
 ### Update SLAS Client
 
 ```bash
@@ -69,3 +115,8 @@ The tenant ID can be set via environment variable:
 ### More Commands
 
 See `b2c slas --help` for a full list of available commands and options in the `slas` topic.
+
+## Related Skills
+
+- `b2c:b2c-custom-api-development` - Creating Custom APIs that require SLAS authentication
+- `b2c-cli:b2c-scapi-custom` - Checking Custom API registration status

plugins/b2c/skills/b2c-custom-api-development/SKILL.md

@@ -269,9 +269,11 @@ When endpoints return 404 or fail to register:
 
 ### For Shopper APIs (ShopperToken)
 
-1. Configure custom scope in SLAS Admin UI
-2. Obtain token via Shopper Login (SLAS)
-3. Include `siteId` in requests
+1. **Create or update a SLAS client** with your custom scope(s)
+   - Use `b2c slas client create --default-scopes --scopes "c_my_scope"` to create a test client
+   - See `b2c-cli:b2c-slas` skill for full client management options
+2. Obtain token via Shopper Login (SLAS) using the client credentials
+3. Include `siteId` in all requests
 
 ### For Admin APIs (AmOAuth2)
 
@@ -342,6 +344,25 @@ See the `b2c-cli:b2c-scapi-custom` skill for more status options.
 
 Test your Custom API endpoints using curl after deployment.
 
+### Prerequisites for Testing
+
+Before testing a Shopper API with custom scopes, ensure you have a SLAS client configured with those scopes:
+
+```bash
+# Create a test client with your custom scope (replace c_my_scope with your scope)
+b2c slas client create \
+  --tenant-id zzpq_013 \
+  --channels RefArch \
+  --default-scopes \
+  --scopes "c_my_scope" \
+  --redirect-uri http://localhost:3000/callback \
+  --json
+
+# Save the client_id and client_secret from the output
+```
+
+See `b2c-cli:b2c-slas` skill for more options.
+
 ### Get a Shopper Token (Private Client)
 
 Using a private SLAS client with client credentials grant:
@@ -373,7 +394,7 @@ curl -s "https://$SHORTCODE.api.commercecloud.salesforce.com/custom/my-api/v1/or
 ### Testing Tips
 
 - Use `b2c slas client list` to find existing SLAS clients
-- Use `b2c slas client create --scopes "c_my_scope,sfcc.shopper-*"` to create a test client
+- Use `b2c slas client create --default-scopes --scopes "c_my_scope"` to create a test client
 - Check logs with `b2c webdav get` from the `logs` root if requests fail
 
 ## HTTP Methods Supported
@@ -463,6 +484,7 @@ See `b2c:b2c-webservices` skill for complete schema documentation, or run `b2c d
 
 - `b2c-cli:b2c-code` - Deploying cartridges and activating code versions
 - `b2c-cli:b2c-scapi-custom` - Checking Custom API registration status
+- `b2c-cli:b2c-slas` - Creating SLAS clients for testing Shopper APIs with custom scopes
 - `b2c:b2c-webservices` - Service configuration, HTTP/FTP/SOAP clients, services.xml format
 - `b2c-cli:b2c-job` - Running jobs and importing site archives