@salesforce/afv-skills 1.16.0 → 1.17.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (40) hide show
  1. package/package.json +1 -1
  2. package/skills/activating-datacloud/SKILL.md +2 -2
  3. package/skills/analyzing-omnistudio-dependencies/SKILL.md +1 -1
  4. package/skills/building-ui-bundle-app/SKILL.md +1 -1
  5. package/skills/connecting-datacloud/SKILL.md +2 -2
  6. package/skills/creating-b2b-commerce-store/SKILL.md +0 -1
  7. package/skills/developing-agentforce/SKILL.md +0 -1
  8. package/skills/generating-apex/SKILL.md +1 -0
  9. package/skills/generating-mermaid-diagrams/assets/datamodel/b2b-commerce-erd.md +1 -1
  10. package/skills/generating-mermaid-diagrams/assets/datamodel/campaigns-erd.md +1 -1
  11. package/skills/generating-mermaid-diagrams/assets/datamodel/consent-erd.md +1 -1
  12. package/skills/generating-mermaid-diagrams/assets/datamodel/files-erd.md +1 -1
  13. package/skills/generating-mermaid-diagrams/assets/datamodel/forecasting-erd.md +1 -1
  14. package/skills/generating-mermaid-diagrams/assets/datamodel/fsl-erd.md +1 -1
  15. package/skills/generating-mermaid-diagrams/assets/datamodel/party-model-erd.md +1 -1
  16. package/skills/generating-mermaid-diagrams/assets/datamodel/quote-order-erd.md +1 -1
  17. package/skills/generating-mermaid-diagrams/assets/datamodel/revenue-cloud-erd.md +1 -1
  18. package/skills/generating-mermaid-diagrams/assets/datamodel/sales-cloud-erd.md +1 -1
  19. package/skills/generating-mermaid-diagrams/assets/datamodel/salesforce-erd.md +1 -1
  20. package/skills/generating-mermaid-diagrams/assets/datamodel/scheduler-erd.md +1 -1
  21. package/skills/generating-mermaid-diagrams/assets/datamodel/service-cloud-erd.md +1 -1
  22. package/skills/generating-mermaid-diagrams/assets/datamodel/territory-management-erd.md +1 -1
  23. package/skills/generating-mermaid-diagrams/references/erd-conventions.md +1 -1
  24. package/skills/generating-mermaid-diagrams/references/preview-guide.md +2 -5
  25. package/skills/harmonizing-datacloud/SKILL.md +2 -2
  26. package/skills/implementing-ui-bundle-agentforce-conversation-client/SKILL.md +1 -2
  27. package/skills/investigating-agentforce-d360/SKILL.md +1 -1
  28. package/skills/observing-agentforce/SKILL.md +0 -1
  29. package/skills/observing-agentforce/references/stdm-queries.md +3 -11
  30. package/skills/orchestrating-datacloud/README.md +5 -7
  31. package/skills/orchestrating-datacloud/SKILL.md +3 -3
  32. package/skills/orchestrating-datacloud/references/feature-readiness.md +2 -2
  33. package/skills/orchestrating-datacloud/references/plugin-setup.md +6 -8
  34. package/skills/orchestrating-datacloud/scripts/diagnose-org.mjs +1 -1
  35. package/skills/orchestrating-datacloud/scripts/verify-plugin.sh +2 -2
  36. package/skills/preparing-datacloud/SKILL.md +2 -2
  37. package/skills/retrieving-datacloud/SKILL.md +3 -3
  38. package/skills/reviewing-lwc-mobile-offline/SKILL.md +0 -1
  39. package/skills/testing-agentforce/SKILL.md +0 -1
  40. package/skills/using-mobile-native-capabilities/SKILL.md +0 -1
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@salesforce/afv-skills",
3
- "version": "1.16.0",
3
+ "version": "1.17.0",
4
4
  "description": "Salesforce skills for Agentforce Vibes",
5
5
  "license": "CC-BY-NC-4.0",
6
6
  "files": [
@@ -40,7 +40,7 @@ Ask for or infer:
40
40
  ## Core Operating Rules
41
41
 
42
42
  - Verify the upstream segment or insight is healthy before creating downstream delivery assets.
43
- - Run the shared readiness classifier before mutating activation assets: `node ~/.claude/skills/orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase act --json`.
43
+ - Run the shared readiness classifier before mutating activation assets: `node ../orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase act --json`.
44
44
  - Inspect available platforms and targets before mutating activation setup.
45
45
  - Keep destination definitions deterministic and reusable where possible.
46
46
  - Treat downstream credential and platform constraints as separate validation concerns.
@@ -52,7 +52,7 @@ Ask for or infer:
52
52
 
53
53
  ### 1. Classify readiness for act work
54
54
  ```bash
55
- node ~/.claude/skills/orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase act --json
55
+ node ../orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase act --json
56
56
  ```
57
57
 
58
58
  ### 2. Inspect destinations first
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: analyzing-omnistudio-dependencies
3
- description: "Cross-cutting OmniStudio analysis skill for namespace detection, dependency visualization, and impact analysis across OmniScripts, FlexCards, Integration Procedures, and Data Mappers. Use this skill to detect which OmniStudio namespace an org uses, build directed dependency graphs, perform impact analysis, and generate Mermaid diagrams of component relationships. TRIGGER when: user asks about OmniStudio dependencies, wants namespace detection (Core vs vlocity_cmt vs vlocity_ins), needs impact analysis, requests dependency diagrams, or asks which components are affected by a change. DO NOT TRIGGER when: authoring OmniScripts (use building-omnistudio-omniscript), building FlexCards (use building-omnistudio-flexcard), creating Integration Procedures (use building-omnistudio-integration-procedure), or configuring Data Mappers (use building-omnistudio-datamapper)."
3
+ description: "Cross-cutting OmniStudio analysis skill for namespace detection, dependency visualization, and impact analysis across OmniScripts, FlexCards, Integration Procedures, and Data Mappers. TRIGGER when: user asks about OmniStudio dependencies, wants namespace detection (Core vs vlocity_cmt vs vlocity_ins), needs impact analysis, requests dependency graphs or Mermaid diagrams, or asks which components are affected by a change. DO NOT TRIGGER when: authoring OmniScripts (use building-omnistudio-omniscript), building FlexCards (use building-omnistudio-flexcard), creating Integration Procedures (use building-omnistudio-integration-procedure), or configuring Data Mappers (use building-omnistudio-datamapper)."
4
4
  metadata:
5
5
  version: "1.0"
6
6
  ---
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: building-ui-bundle-app
3
- description: "MUST activate when the user wants to build, create, or generate a React application, React app, web application, single-page application (SPA), or frontend application — even if no project files exist yet. MUST also activate when the project contains a uiBundles/*/src/ directory or sfdx-project.json and the prompt says create, build, construct, or generate a new app, site, or page from scratch — even if the prompt also describes visual styling. MUST also activate when the task spans more than one ui-bundle skill. Use this skill when building a complete app end-to-end. This is the orchestrator that coordinates scaffolding, features, data access, frontend UI, integrations, and deployment in the correct dependency order. Without it, phases execute out of order and the app breaks. Do NOT use for Lightning Experience apps with custom objects (use generating-lightning-app). Do NOT use for single-concern edits to an existing page (use building-ui-bundle-frontend)."
3
+ description: "MUST activate when the user wants to build, create, or generate a React application, React app, web application, single-page application (SPA), or frontend application — even if no project files exist yet. MUST also activate when the project contains a uiBundles/*/src/ directory or sfdx-project.json and the prompt says create, build, construct, or generate a new app, site, or page from scratch — even if the prompt also describes visual styling. MUST also activate when the task spans more than one ui-bundle skill. Use this skill when building a complete app end-to-end. Do NOT use for Lightning Experience apps with custom objects (use generating-lightning-app). Do NOT use for single-concern edits to an existing page (use building-ui-bundle-frontend)."
4
4
  metadata:
5
5
  version: "1.0"
6
6
  related-skills: generating-ui-bundle-metadata, generating-ui-bundle-features, using-ui-bundle-salesforce-data, building-ui-bundle-frontend, implementing-ui-bundle-agentforce-conversation-client, implementing-ui-bundle-file-upload, deploying-ui-bundle, generating-ui-bundle-site, generating-ui-bundle-custom-app
@@ -43,7 +43,7 @@ Ask for or infer:
43
43
  ## Core Operating Rules
44
44
 
45
45
  - Verify the plugin runtime first; see [../orchestrating-datacloud/references/plugin-setup.md](../orchestrating-datacloud/references/plugin-setup.md).
46
- - Run the shared readiness classifier before mutating connections: `node ~/.claude/skills/orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase connect --json`.
46
+ - Run the shared readiness classifier before mutating connections: `node ../orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase connect --json`.
47
47
  - Prefer read-only discovery before connection creation.
48
48
  - Suppress linked-plugin warning noise with `2>/dev/null` for standard usage.
49
49
  - Remember that `connection list` requires `--connector-type`.
@@ -59,7 +59,7 @@ Ask for or infer:
59
59
 
60
60
  ### 1. Classify readiness for connect work
61
61
  ```bash
62
- node ~/.claude/skills/orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase connect --json
62
+ node ../orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase connect --json
63
63
  ```
64
64
 
65
65
  ### 2. Discover connector types
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: creating-b2b-commerce-store
3
3
  description: "Interactive workflow to create Commerce B2B Stores and retrieve storefront metadata. Use when users want to: create B2B Commerce stores, build Commerce storefronts, set up B2B stores from Vibes, retrieve Commerce metadata, deploy Commerce experiences, work with DigitalExperienceBundle for Commerce."
4
- Critical: "Agents must follow the interactive flow and NEVER create storefront metadata from scratch."
5
4
  compatibility: "Requires Commerce licenses, Experience Cloud, Salesforce CLI"
6
5
  metadata:
7
6
  version: "1.0"
@@ -4,7 +4,6 @@ description: "Build, modify, debug, and deploy agents with Agentforce Agent Scri
4
4
  compatibility: "Requires Agentforce license, API v66.0+, Einstein Agent User"
5
5
  metadata:
6
6
  version: "1.0"
7
- last_updated: "2026-04-08"
8
7
  ---
9
8
 
10
9
  # Agent Script Skill
@@ -3,6 +3,7 @@ name: generating-apex
3
3
  description: "Primary Apex authoring skill for class generation, refactoring, and review. ALWAYS ACTIVATE when the user mentions Apex, .cls, triggers, or asks to create/refactor a class (service, selector, domain, batch, queueable, schedulable, invocable, DTO, utility, interface, abstract, exception, REST resource). Use this skill for requests involving SObject CRUD, mapping collections, fetching related records, scheduled jobs, batch jobs, trigger design, @AuraEnabled controllers, @RestResource endpoints, custom REST APIs, or code review of existing Apex."
4
4
  metadata:
5
5
  version: "1.0"
6
+ minApiVersion: "66.0"
6
7
  ---
7
8
 
8
9
  # Generating Apex
@@ -22,7 +22,7 @@ Pre-built data model for Salesforce B2B Commerce using `flowchart LR` format wit
22
22
  Enrich diagram with live org data:
23
23
 
24
24
  ```bash
25
- python3 ~/.claude/skills/generating-mermaid-diagrams/scripts/query-org-metadata.py \
25
+ python3 ../../scripts/query-org-metadata.py \
26
26
  --objects WebStore,WebCart,CartItem,BuyerGroup,BuyerAccount \
27
27
  --target-org myorg
28
28
  ```
@@ -21,7 +21,7 @@ Pre-built data model for Salesforce Campaigns using `flowchart LR` format with c
21
21
  Enrich diagram with live org data:
22
22
 
23
23
  ```bash
24
- python3 ~/.claude/skills/generating-mermaid-diagrams/scripts/query-org-metadata.py \
24
+ python3 ../../scripts/query-org-metadata.py \
25
25
  --objects Campaign,CampaignMember,CampaignInfluence,Lead,Contact,Opportunity \
26
26
  --target-org myorg
27
27
  ```
@@ -24,7 +24,7 @@ Pre-built data model for Salesforce Consent Management (GDPR/Privacy) using `flo
24
24
  Enrich diagram with live org data:
25
25
 
26
26
  ```bash
27
- python3 ~/.claude/skills/generating-mermaid-diagrams/scripts/query-org-metadata.py \
27
+ python3 ../../scripts/query-org-metadata.py \
28
28
  --objects Individual,ContactPointEmail,ContactPointPhone,DataUsePurpose,ContactPointConsent \
29
29
  --target-org myorg
30
30
  ```
@@ -21,7 +21,7 @@ Pre-built data model for Salesforce Files (Content) using `flowchart LR` format
21
21
  Enrich diagram with live org data:
22
22
 
23
23
  ```bash
24
- python3 ~/.claude/skills/generating-mermaid-diagrams/scripts/query-org-metadata.py \
24
+ python3 ../../scripts/query-org-metadata.py \
25
25
  --objects ContentDocument,ContentVersion,ContentDocumentLink,ContentWorkspace \
26
26
  --target-org myorg
27
27
  ```
@@ -21,7 +21,7 @@ Pre-built data model for Salesforce Collaborative Forecasts using `flowchart LR`
21
21
  Enrich diagram with live org data:
22
22
 
23
23
  ```bash
24
- python3 ~/.claude/skills/generating-mermaid-diagrams/scripts/query-org-metadata.py \
24
+ python3 ../../scripts/query-org-metadata.py \
25
25
  --objects ForecastingItem,ForecastingQuota,Opportunity,OpportunitySplit \
26
26
  --target-org myorg
27
27
  ```
@@ -25,7 +25,7 @@ Pre-built data model for Salesforce Field Service (formerly Field Service Lightn
25
25
  Enrich diagram with live org data:
26
26
 
27
27
  ```bash
28
- python3 ~/.claude/skills/generating-mermaid-diagrams/scripts/query-org-metadata.py \
28
+ python3 ../../scripts/query-org-metadata.py \
29
29
  --objects WorkOrder,WorkOrderLineItem,ServiceAppointment,ServiceResource,ServiceTerritory \
30
30
  --target-org myorg
31
31
  ```
@@ -20,7 +20,7 @@ Pre-built data model for Salesforce Party Model used in Industry Clouds (Financi
20
20
  Enrich diagram with live org data:
21
21
 
22
22
  ```bash
23
- python3 ~/.claude/skills/generating-mermaid-diagrams/scripts/query-org-metadata.py \
23
+ python3 ../../scripts/query-org-metadata.py \
24
24
  --objects Account,Contact,AccountContactRelation,AccountContactRole \
25
25
  --target-org myorg
26
26
  ```
@@ -23,7 +23,7 @@ Pre-built data model for Salesforce Quotes and Orders using `flowchart LR` forma
23
23
  Enrich diagram with live org data:
24
24
 
25
25
  ```bash
26
- python3 ~/.claude/skills/generating-mermaid-diagrams/scripts/query-org-metadata.py \
26
+ python3 ../../scripts/query-org-metadata.py \
27
27
  --objects Opportunity,Quote,QuoteLineItem,Order,OrderItem,Product2,Contract \
28
28
  --target-org myorg
29
29
  ```
@@ -22,7 +22,7 @@ Pre-built data model for Salesforce Revenue Cloud (CPQ, Billing, Subscription Ma
22
22
  Enrich diagram with live org data:
23
23
 
24
24
  ```bash
25
- python3 ~/.claude/skills/generating-mermaid-diagrams/scripts/query-org-metadata.py \
25
+ python3 ../../scripts/query-org-metadata.py \
26
26
  --objects ProductCatalog,ProductCategory,ProductSellingModel,PriceAdjustmentSchedule \
27
27
  --target-org myorg
28
28
  ```
@@ -22,7 +22,7 @@ Pre-built data model for Salesforce Sales Cloud using `flowchart LR` format with
22
22
  Enrich diagram with live org data:
23
23
 
24
24
  ```bash
25
- python3 ~/.claude/skills/generating-mermaid-diagrams/scripts/query-org-metadata.py \
25
+ python3 ../../scripts/query-org-metadata.py \
26
26
  --objects Account,Contact,Lead,Opportunity,Product2,Campaign \
27
27
  --target-org myorg
28
28
  ```
@@ -56,7 +56,7 @@ Use `flowchart LR` (left-to-right) for data model diagrams. This format supports
56
56
  Enrich diagrams with live org data:
57
57
 
58
58
  ```bash
59
- python3 ~/.claude/skills/generating-mermaid-diagrams/scripts/query-org-metadata.py \
59
+ python3 ../../scripts/query-org-metadata.py \
60
60
  --objects Account,Contact,Opportunity,Case \
61
61
  --target-org myorg
62
62
  ```
@@ -23,7 +23,7 @@ Pre-built data model for Salesforce Scheduler (Lightning Scheduler) using `flowc
23
23
  Enrich diagram with live org data:
24
24
 
25
25
  ```bash
26
- python3 ~/.claude/skills/generating-mermaid-diagrams/scripts/query-org-metadata.py \
26
+ python3 ../../scripts/query-org-metadata.py \
27
27
  --objects ServiceAppointment,ServiceResource,ServiceTerritory,WorkType \
28
28
  --target-org myorg
29
29
  ```
@@ -23,7 +23,7 @@ Pre-built data model for Salesforce Service Cloud using `flowchart LR` format wi
23
23
  Enrich diagram with live org data:
24
24
 
25
25
  ```bash
26
- python3 ~/.claude/skills/generating-mermaid-diagrams/scripts/query-org-metadata.py \
26
+ python3 ../../scripts/query-org-metadata.py \
27
27
  --objects Account,Contact,Case,Entitlement,ServiceContract,Asset \
28
28
  --target-org myorg
29
29
  ```
@@ -20,7 +20,7 @@ Pre-built data model for Salesforce Enterprise Territory Management (Territory2)
20
20
  Enrich diagram with live org data:
21
21
 
22
22
  ```bash
23
- python3 ~/.claude/skills/generating-mermaid-diagrams/scripts/query-org-metadata.py \
23
+ python3 ../../scripts/query-org-metadata.py \
24
24
  --objects Territory2Model,Territory2,Territory2Type,UserTerritory2Association,ObjectTerritory2Association \
25
25
  --target-org myorg
26
26
  ```
@@ -210,7 +210,7 @@ style std fill:#f0f9ff,stroke:#0369a1,stroke-dasharray:5
210
210
  Use the provided Python script for efficient metadata queries:
211
211
 
212
212
  ```bash
213
- python3 ~/.claude/skills/generating-mermaid-diagrams/scripts/query-org-metadata.py \
213
+ python3 ../scripts/query-org-metadata.py \
214
214
  --objects Account,Contact,Lead,Opportunity,Case \
215
215
  --target-org myorg \
216
216
  --output table
@@ -14,10 +14,7 @@ After generating the diagram, offer the user a localhost preview for real-time i
14
14
  2. Start preview server (runs in background):
15
15
  ```bash
16
16
  # From installed skill folder:
17
- python ~/.claude/skills/generating-mermaid-diagrams/scripts/mermaid_preview.py start --file /tmp/mermaid-preview.mmd
18
-
19
- # Or from project folder (if working locally):
20
- python [project-root]/skills/generating-mermaid-diagrams/scripts/mermaid_preview.py start --file /tmp/mermaid-preview.mmd
17
+ python ../scripts/mermaid_preview.py start --file /tmp/mermaid-preview.mmd
21
18
  ```
22
19
 
23
20
  3. Provide URL to user:
@@ -37,7 +34,7 @@ After generating the diagram, offer the user a localhost preview for real-time i
37
34
 
38
35
  When user is done:
39
36
  ```bash
40
- python ~/.claude/skills/generating-mermaid-diagrams/scripts/mermaid_preview.py stop
37
+ python ../scripts/mermaid_preview.py stop
41
38
  ```
42
39
 
43
40
  ## Preview Server Features
@@ -40,7 +40,7 @@ Ask for or infer:
40
40
  ## Core Operating Rules
41
41
 
42
42
  - Inspect DMO schema before creating mappings.
43
- - Run the shared readiness classifier before mutating harmonization assets: `node ~/.claude/skills/orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase harmonize --json`.
43
+ - Run the shared readiness classifier before mutating harmonization assets: `node ../orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase harmonize --json`.
44
44
  - Prefer `dmo list --all` when browsing the catalog, but use first-page `dmo list` for fast readiness checks.
45
45
  - Use `query describe` or `dmo get --json` instead of inventing unsupported describe flows.
46
46
  - Treat identity resolution runs as asynchronous and verify results after execution.
@@ -52,7 +52,7 @@ Ask for or infer:
52
52
 
53
53
  ### 1. Classify readiness for harmonize work
54
54
  ```bash
55
- node ~/.claude/skills/orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase harmonize --json
55
+ node ../orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase harmonize --json
56
56
  ```
57
57
 
58
58
  ### 2. Inspect the catalog
@@ -1,8 +1,7 @@
1
1
  ---
2
2
  name: implementing-ui-bundle-agentforce-conversation-client
3
- description: "Use this skill when the user asks to add, embed, integrate, configure, style, or remove an agent, chatbot, chat widget, conversation client, or AI assistant in a UI Bundle project. Covers styling (colors, fonts, spacing, borders), layout (inline vs floating, width, height, dimensions), and props (agentId, agentLabel, headerEnabled, showHeaderIcon, showAvatar, styleTokens). TRIGGER when: project contains a uiBundles/*/src/ directory and the task involves adding or modifying a chat widget, chatbot, or conversational AI; files under uiBundles/*/src/ import AgentforceConversationClient; user asks to add any chat or agent functionality to a page. DO NOT TRIGGER when: user wants to create a custom agent, chatbot, or chat widget component from scratch; the project has no uiBundles directory."
3
+ description: "Use this skill when the user asks to add, embed, integrate, configure, style, or remove an agent, chatbot, chat widget, conversation client, or AI assistant in a UI Bundle project. TRIGGER when: project contains a uiBundles/*/src/ directory and the task involves adding or modifying a chat widget, chatbot, or conversational AI; files under uiBundles/*/src/ import AgentforceConversationClient; user asks to add any chat or agent functionality to a page. DO NOT TRIGGER when: user wants to create a custom agent, chatbot, or chat widget component from scratch; the project has no uiBundles directory."
4
4
  metadata:
5
- author: ACC Components
6
5
  version: "1.1"
7
6
  package: "@salesforce/ui-bundle-template-feature-react-agentforce-conversation-client"
8
7
  sdk-package: "@salesforce/agentforce-conversation-client"
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: investigating-agentforce-d360
3
- description: "Data Cloud 360° view of a single Agentforce session. Pulls 24 STDM + GenAI DMO rows via the DC Query REST API, assembles a hierarchical session tree (Interaction → Step → Generation → GatewayRequest), renders a human-readable summary with transcript + per-turn topic/action invocations + LLM generations + tool calls + audit chain. TRIGGER when user asks to trace, inspect, summarize, or describe a specific Agentforce session by session id (Agent Session UUID `019d…` or MessagingSession id `0Mw…`). Also triggers on session discovery — find/list/search sessions by time, agent, channel, outcome, or conversation text — when the user has no session id yet. DO NOT TRIGGER for design-time architecture questions (use investigating-agentforce-architecture instead) or for runtime perf/latency/SLO questions that require platform telemetry beyond Data Cloud."
3
+ description: "Data Cloud 360° view of a single Agentforce session. TRIGGER when user asks to trace, inspect, summarize, or describe a specific Agentforce session by session id (Agent Session UUID `019d…` or MessagingSession id `0Mw…`). Also triggers on session discovery — find/list/search sessions by time, agent, channel, outcome, or conversation text — when the user has no session id yet. DO NOT TRIGGER for design-time architecture questions (use investigating-agentforce-architecture instead) or for runtime perf/latency/SLO questions that require platform telemetry beyond Data Cloud."
4
4
  metadata:
5
5
  version: "1.0"
6
6
  ---
@@ -4,7 +4,6 @@ description: "Analyze production Agentforce agent behavior using session traces
4
4
  allowed-tools: Bash Read Write Edit Glob Grep
5
5
  metadata:
6
6
  version: "1.0"
7
- last_updated: "2026-04-08"
8
7
  argument-hint: "<org-alias> [--agent-file <path>] [--session-id <id>] [--days <n>]"
9
8
  compatibility: claude-code
10
9
  ---
@@ -23,18 +23,10 @@ Methods:
23
23
  # Ensure the classes directory exists
24
24
  mkdir -p <project-root>/force-app/main/default/classes
25
25
 
26
- # Copy from the installed skill location
27
- cp skills/observing-agentforce/apex/AgentforceOptimizeService.cls \
26
+ # Copy from the skill's apex directory
27
+ cp ../apex/AgentforceOptimizeService.cls \
28
28
  <project-root>/force-app/main/default/classes/
29
- cp skills/observing-agentforce/apex/AgentforceOptimizeService.cls-meta.xml \
30
- <project-root>/force-app/main/default/classes/
31
- ```
32
-
33
- If the skill is installed globally via the installer, use the installed path:
34
- ```bash
35
- cp ~/.claude/skills/observing-agentforce/apex/AgentforceOptimizeService.cls \
36
- <project-root>/force-app/main/default/classes/
37
- cp ~/.claude/skills/observing-agentforce/apex/AgentforceOptimizeService.cls-meta.xml \
29
+ cp ../apex/AgentforceOptimizeService.cls-meta.xml \
38
30
  <project-root>/force-app/main/default/classes/
39
31
  ```
40
32
 
@@ -63,14 +63,12 @@ These are intentionally generic and should be adapted to the target org.
63
63
 
64
64
  ## Quick start
65
65
 
66
- > The script examples below assume the skill is installed under `~/.claude/skills/` via the full Claude Code installer. If you are working from a repo checkout, run the same scripts from that checkout path.
67
-
68
66
  ### 1. Verify the runtime
69
67
 
70
68
  ```bash
71
- bash ~/.claude/skills/orchestrating-datacloud/scripts/verify-plugin.sh
69
+ bash ./scripts/verify-plugin.sh
72
70
  # or with an org alias
73
- bash ~/.claude/skills/orchestrating-datacloud/scripts/verify-plugin.sh myorg
71
+ bash ./scripts/verify-plugin.sh myorg
74
72
  ```
75
73
 
76
74
  The helper treats `sf data360 doctor` as advisory and falls back to additional read-only smoke checks when an org is only partially provisioned.
@@ -78,9 +76,9 @@ The helper treats `sf data360 doctor` as advisory and falls back to additional r
78
76
  ### 2. Diagnose feature readiness before mutating
79
77
 
80
78
  ```bash
81
- node ~/.claude/skills/orchestrating-datacloud/scripts/diagnose-org.mjs -o myorg --json
79
+ node ./scripts/diagnose-org.mjs -o myorg --json
82
80
  # optional retrieve-plane probe, only when you know the table is real
83
- node ~/.claude/skills/orchestrating-datacloud/scripts/diagnose-org.mjs -o myorg --phase retrieve --describe-table MyDMO__dlm --json
81
+ node ./scripts/diagnose-org.mjs -o myorg --phase retrieve --describe-table MyDMO__dlm --json
84
82
  ```
85
83
 
86
84
  Use the diagnose helper to distinguish between:
@@ -94,7 +92,7 @@ Use the diagnose helper to distinguish between:
94
92
  ```bash
95
93
  python3 ~/.claude/sf-skills-install.py --with-datacloud-runtime
96
94
  # or run the helper script directly
97
- bash ~/.claude/skills/orchestrating-datacloud/scripts/bootstrap-plugin.sh
95
+ bash ./scripts/bootstrap-plugin.sh
98
96
  ```
99
97
 
100
98
  ### 4. Start with read-only inspection
@@ -92,7 +92,7 @@ Recommended checks:
92
92
  ```bash
93
93
  sf data360 man
94
94
  sf org display -o <alias>
95
- bash ~/.claude/skills/orchestrating-datacloud/scripts/verify-plugin.sh <alias>
95
+ bash ./scripts/verify-plugin.sh <alias>
96
96
  ```
97
97
 
98
98
  Treat `sf data360 doctor` as a broad health signal, not the sole gate. On partially provisioned orgs it can fail even when read-only command families like connectors, DMOs, or segments still work.
@@ -100,12 +100,12 @@ Treat `sf data360 doctor` as a broad health signal, not the sole gate. On partia
100
100
  ### 2. Classify readiness before changing anything
101
101
  Run the shared classifier first:
102
102
  ```bash
103
- node ~/.claude/skills/orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --json
103
+ node ./scripts/diagnose-org.mjs -o <org> --json
104
104
  ```
105
105
 
106
106
  Only use a query-plane probe after you know the table name is real:
107
107
  ```bash
108
- node ~/.claude/skills/orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase retrieve --describe-table MyDMO__dlm --json
108
+ node ./scripts/diagnose-org.mjs -o <org> --phase retrieve --describe-table MyDMO__dlm --json
109
109
  ```
110
110
 
111
111
  Use the classifier to distinguish:
@@ -27,13 +27,13 @@ Examples:
27
27
  Run the shared readiness classifier before mutation-heavy work:
28
28
 
29
29
  ```bash
30
- node ~/.claude/skills/orchestrating-datacloud/scripts/diagnose-org.mjs -o myorg --json
30
+ node ../scripts/diagnose-org.mjs -o myorg --json
31
31
  ```
32
32
 
33
33
  For retrieve/query work, only add a table probe when you already know the table name is real:
34
34
 
35
35
  ```bash
36
- node ~/.claude/skills/orchestrating-datacloud/scripts/diagnose-org.mjs -o myorg --phase retrieve --describe-table MyDMO__dlm --json
36
+ node ../scripts/diagnose-org.mjs -o myorg --phase retrieve --describe-table MyDMO__dlm --json
37
37
  ```
38
38
 
39
39
  ## Signal matrix
@@ -18,8 +18,6 @@ The orchestrating-datacloud family uses a **community `sf data360` CLI runtime**
18
18
 
19
19
  ## Recommended setup path
20
20
 
21
- The command examples below assume the skill is installed under `~/.claude/skills/` via the full Claude Code installer. If you are working from a cloned sf-skills repo instead, run the same scripts from that checkout path.
22
-
23
21
  If you use the Python installer, it can install this optional runtime for you:
24
22
 
25
23
  ```bash
@@ -29,7 +27,7 @@ python3 ~/.claude/sf-skills-install.py --with-datacloud-runtime
29
27
  Or use the helper script directly:
30
28
 
31
29
  ```bash
32
- bash ~/.claude/skills/orchestrating-datacloud/scripts/bootstrap-plugin.sh
30
+ bash ../scripts/bootstrap-plugin.sh
33
31
  ```
34
32
 
35
33
  By default it clones the plugin into `~/.sf-community-tools/datacloud/sf-cli-plugin-data360`, installs dependencies, compiles it, and links it into the local Salesforce CLI.
@@ -41,7 +39,7 @@ git clone https://github.com/Jaganpro/sf-cli-plugin-data360.git
41
39
  cd sf-cli-plugin-data360
42
40
  yarn install
43
41
  npx tsc
44
- node ~/.claude/skills/orchestrating-datacloud/scripts/generate-manifest.mjs .
42
+ node ../scripts/generate-manifest.mjs .
45
43
  sf plugins link .
46
44
  ```
47
45
 
@@ -49,9 +47,9 @@ sf plugins link .
49
47
 
50
48
  ```bash
51
49
  sf data360 man
52
- bash ~/.claude/skills/orchestrating-datacloud/scripts/verify-plugin.sh
53
- bash ~/.claude/skills/orchestrating-datacloud/scripts/verify-plugin.sh myorg
54
- node ~/.claude/skills/orchestrating-datacloud/scripts/diagnose-org.mjs -o myorg --json
50
+ bash ../scripts/verify-plugin.sh
51
+ bash ../scripts/verify-plugin.sh myorg
52
+ node ../scripts/diagnose-org.mjs -o myorg --json
55
53
  ```
56
54
 
57
55
  For newer command families such as `sf data360 query hybrid` and recent pagination fixes, update the community runtime to the latest upstream commit by re-running the bootstrap helper.
@@ -80,7 +78,7 @@ sf data360 segment list -o myorg 2>/dev/null
80
78
  If you see `Warning: @gthoppae/sf-cli-plugin-data360 is a linked ESM module and cannot be auto-transpiled`, generate the oclif command manifest:
81
79
 
82
80
  ```bash
83
- node ~/.claude/skills/orchestrating-datacloud/scripts/generate-manifest.mjs ~/.sf-community-tools/datacloud/sf-cli-plugin-data360
81
+ node ../scripts/generate-manifest.mjs ~/.sf-community-tools/datacloud/sf-cli-plugin-data360
84
82
  ```
85
83
 
86
84
  This tells oclif to use pre-compiled output directly instead of attempting auto-transpilation. The `npx oclif manifest` alternative may fail on newer Node.js versions due to `@oclif/core` version mismatches.
@@ -257,7 +257,7 @@ function guidanceFromProbe(scope, probe) {
257
257
  if (probe.state === 'runtime_missing') {
258
258
  return [
259
259
  'Install or relink the community sf data360 runtime before attempting Data Cloud work.',
260
- 'Use python3 ~/.claude/sf-skills-install.py --with-datacloud-runtime or bash ~/.claude/skills/orchestrating-datacloud/scripts/bootstrap-plugin.sh.',
260
+ 'Use python3 ~/.claude/sf-skills-install.py --with-datacloud-runtime or bash ./scripts/bootstrap-plugin.sh.',
261
261
  ];
262
262
  }
263
263
 
@@ -10,7 +10,7 @@ fi
10
10
 
11
11
  if ! sf data360 man >/dev/null 2>&1; then
12
12
  echo "The community 'sf data360' runtime is not available." >&2
13
- echo "Run bash ~/.claude/skills/orchestrating-datacloud/scripts/bootstrap-plugin.sh first." >&2
13
+ echo "Run bash ./scripts/bootstrap-plugin.sh first." >&2
14
14
  exit 1
15
15
  fi
16
16
 
@@ -54,5 +54,5 @@ fi
54
54
 
55
55
  echo "Verification complete."
56
56
  if [[ -n "${ORG}" ]]; then
57
- echo "Next: node ~/.claude/skills/orchestrating-datacloud/scripts/diagnose-org.mjs -o '${ORG}' --json"
57
+ echo "Next: node ./scripts/diagnose-org.mjs -o '${ORG}' --json"
58
58
  fi
@@ -44,7 +44,7 @@ Ask for or infer:
44
44
  ## Core Operating Rules
45
45
 
46
46
  - Verify the external plugin runtime before running Data Cloud commands.
47
- - Run the shared readiness classifier before mutating ingestion assets: `node ~/.claude/skills/orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase prepare --json`.
47
+ - Run the shared readiness classifier before mutating ingestion assets: `node ../orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase prepare --json`.
48
48
  - Prefer inspecting existing streams and DLOs before creating new ingestion assets.
49
49
  - Suppress linked-plugin warning noise with `2>/dev/null` for normal usage.
50
50
  - Treat DLO naming and field naming as Data Cloud-specific, not CRM-native.
@@ -59,7 +59,7 @@ Ask for or infer:
59
59
 
60
60
  ### 1. Classify readiness for prepare work
61
61
  ```bash
62
- node ~/.claude/skills/orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase prepare --json
62
+ node ../orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase prepare --json
63
63
  ```
64
64
 
65
65
  ### 2. Inspect existing ingestion assets
@@ -39,7 +39,7 @@ Ask for or infer:
39
39
  ## Core Operating Rules
40
40
 
41
41
  - Treat Data Cloud SQL as its own query language, not SOQL.
42
- - Run the shared readiness classifier before relying on query/search surfaces: `node ~/.claude/skills/orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase retrieve --json`.
42
+ - Run the shared readiness classifier before relying on query/search surfaces: `node ../orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase retrieve --json`.
43
43
  - Use describe before guessing columns.
44
44
  - Prefer `sqlv2` or async query flows for larger result sets.
45
45
  - Use vector search or hybrid search only when the search index lifecycle is healthy.
@@ -51,9 +51,9 @@ Ask for or infer:
51
51
 
52
52
  ### 1. Classify readiness for retrieve work
53
53
  ```bash
54
- node ~/.claude/skills/orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase retrieve --json
54
+ node ../orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase retrieve --json
55
55
  # optional query-plane probe, only with a real table name
56
- node ~/.claude/skills/orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase retrieve --describe-table MyDMO__dlm --json
56
+ node ../orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase retrieve --describe-table MyDMO__dlm --json
57
57
  ```
58
58
 
59
59
  ### 2. Choose the smallest correct query shape
@@ -4,7 +4,6 @@ description: "Review a Lightning Web Component for **mobile offline** compatibil
4
4
  metadata:
5
5
  version: "1.0"
6
6
  ---
7
- <!-- adk-managed-skill -->
8
7
 
9
8
  # Reviewing LWC Mobile Offline
10
9
 
@@ -4,7 +4,6 @@ description: "Write, run, and analyze structured test suites for Agentforce agen
4
4
  allowed-tools: Bash Read Write Edit Glob Grep
5
5
  metadata:
6
6
  version: "1.0"
7
- last_updated: "2026-04-08"
8
7
  argument-hint: "<org-alias> --authoring-bundle <AgentName> [--utterances <file>] | run <org> --target <flow://Name>"
9
8
  compatibility: claude-code
10
9
  ---
@@ -4,7 +4,6 @@ description: "Build a Salesforce LWC that uses native mobile device capabilities
4
4
  metadata:
5
5
  version: "1.0"
6
6
  ---
7
- <!-- adk-managed-skill -->
8
7
 
9
8
  # Using Mobile Native Capabilities
10
9