@salesforce/afv-skills 1.15.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 (62) hide show
  1. package/package.json +1 -1
  2. package/skills/activating-datacloud/SKILL.md +2 -3
  3. package/skills/analyzing-omnistudio-dependencies/SKILL.md +1 -2
  4. package/skills/building-mobile-apps/SKILL.md +0 -1
  5. package/skills/building-omnistudio-callable-apex/SKILL.md +0 -1
  6. package/skills/building-omnistudio-datamapper/SKILL.md +0 -1
  7. package/skills/building-omnistudio-flexcard/SKILL.md +0 -1
  8. package/skills/building-omnistudio-integration-procedure/SKILL.md +0 -1
  9. package/skills/building-omnistudio-omniscript/SKILL.md +0 -1
  10. package/skills/building-sf-integrations/SKILL.md +0 -1
  11. package/skills/building-ui-bundle-app/SKILL.md +1 -1
  12. package/skills/configuring-connected-apps/SKILL.md +0 -1
  13. package/skills/connecting-datacloud/SKILL.md +2 -3
  14. package/skills/creating-b2b-commerce-store/SKILL.md +0 -2
  15. package/skills/debugging-apex-logs/SKILL.md +0 -1
  16. package/skills/deploying-metadata/SKILL.md +0 -1
  17. package/skills/deploying-omnistudio-datapacks/SKILL.md +0 -1
  18. package/skills/developing-agentforce/SKILL.md +0 -2
  19. package/skills/fetching-salesforce-docs/SKILL.md +0 -1
  20. package/skills/generating-apex/SKILL.md +1 -0
  21. package/skills/generating-lwc-components/SKILL.md +0 -1
  22. package/skills/generating-mermaid-diagrams/SKILL.md +0 -1
  23. package/skills/generating-mermaid-diagrams/assets/datamodel/b2b-commerce-erd.md +1 -1
  24. package/skills/generating-mermaid-diagrams/assets/datamodel/campaigns-erd.md +1 -1
  25. package/skills/generating-mermaid-diagrams/assets/datamodel/consent-erd.md +1 -1
  26. package/skills/generating-mermaid-diagrams/assets/datamodel/files-erd.md +1 -1
  27. package/skills/generating-mermaid-diagrams/assets/datamodel/forecasting-erd.md +1 -1
  28. package/skills/generating-mermaid-diagrams/assets/datamodel/fsl-erd.md +1 -1
  29. package/skills/generating-mermaid-diagrams/assets/datamodel/party-model-erd.md +1 -1
  30. package/skills/generating-mermaid-diagrams/assets/datamodel/quote-order-erd.md +1 -1
  31. package/skills/generating-mermaid-diagrams/assets/datamodel/revenue-cloud-erd.md +1 -1
  32. package/skills/generating-mermaid-diagrams/assets/datamodel/sales-cloud-erd.md +1 -1
  33. package/skills/generating-mermaid-diagrams/assets/datamodel/salesforce-erd.md +1 -1
  34. package/skills/generating-mermaid-diagrams/assets/datamodel/scheduler-erd.md +1 -1
  35. package/skills/generating-mermaid-diagrams/assets/datamodel/service-cloud-erd.md +1 -1
  36. package/skills/generating-mermaid-diagrams/assets/datamodel/territory-management-erd.md +1 -1
  37. package/skills/generating-mermaid-diagrams/references/erd-conventions.md +1 -1
  38. package/skills/generating-mermaid-diagrams/references/preview-guide.md +2 -5
  39. package/skills/generating-visual-diagrams/SKILL.md +0 -1
  40. package/skills/handling-sf-data/SKILL.md +0 -1
  41. package/skills/harmonizing-datacloud/SKILL.md +2 -3
  42. package/skills/implementing-ui-bundle-agentforce-conversation-client/SKILL.md +1 -2
  43. package/skills/integrating-b2b-commerce-open-code-components/SKILL.md +0 -1
  44. package/skills/investigating-agentforce-d360/SKILL.md +1 -1
  45. package/skills/modeling-omnistudio-epc-catalog/SKILL.md +0 -1
  46. package/skills/observing-agentforce/SKILL.md +0 -2
  47. package/skills/observing-agentforce/references/stdm-queries.md +3 -11
  48. package/skills/orchestrating-datacloud/README.md +5 -7
  49. package/skills/orchestrating-datacloud/SKILL.md +3 -4
  50. package/skills/orchestrating-datacloud/references/feature-readiness.md +2 -2
  51. package/skills/orchestrating-datacloud/references/plugin-setup.md +6 -8
  52. package/skills/orchestrating-datacloud/scripts/diagnose-org.mjs +1 -1
  53. package/skills/orchestrating-datacloud/scripts/verify-plugin.sh +2 -2
  54. package/skills/preparing-datacloud/SKILL.md +2 -3
  55. package/skills/querying-soql/SKILL.md +0 -1
  56. package/skills/retrieving-datacloud/SKILL.md +3 -4
  57. package/skills/reviewing-lwc-mobile-offline/SKILL.md +0 -1
  58. package/skills/running-apex-tests/SKILL.md +0 -1
  59. package/skills/running-code-analyzer/SKILL.md +0 -1
  60. package/skills/segmenting-datacloud/SKILL.md +0 -1
  61. package/skills/testing-agentforce/SKILL.md +0 -2
  62. 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.15.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": [
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: activating-datacloud
3
3
  description: "Salesforce Data Cloud Act phase. Use this skill when the user manages activations, activation targets, data actions, or downstream delivery of Data Cloud audiences and data. TRIGGER when: user manages activations, activation targets, data actions, or downstream delivery of Data Cloud audiences and data. DO NOT TRIGGER when: the task is segment creation (use segmenting-datacloud), data retrieval/search work (use retrieving-datacloud), or STDM/session tracing (use observing-agentforce)."
4
- license: MIT
5
4
  compatibility: "Requires an external community sf data360 CLI plugin and a Data Cloud-enabled org"
6
5
  metadata:
7
6
  version: "1.0"
@@ -41,7 +40,7 @@ Ask for or infer:
41
40
  ## Core Operating Rules
42
41
 
43
42
  - Verify the upstream segment or insight is healthy before creating downstream delivery assets.
44
- - 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`.
45
44
  - Inspect available platforms and targets before mutating activation setup.
46
45
  - Keep destination definitions deterministic and reusable where possible.
47
46
  - Treat downstream credential and platform constraints as separate validation concerns.
@@ -53,7 +52,7 @@ Ask for or infer:
53
52
 
54
53
  ### 1. Classify readiness for act work
55
54
  ```bash
56
- 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
57
56
  ```
58
57
 
59
58
  ### 2. Inspect destinations first
@@ -1,7 +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)."
4
- license: MIT
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)."
5
4
  metadata:
6
5
  version: "1.0"
7
6
  ---
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: building-mobile-apps
3
3
  description: "The entry point for building any Salesforce native mobile app on iOS or Android. TRIGGER when the user says: \"build a Salesforce iOS app\", \"add Salesforce login to my Android app\", \"set up Mobile SDK\", \"add MobileSync / SmartStore offline storage\", \"embed an Agentforce agent in my mobile app\", \"add Agentforce chat to iOS/Android\", or otherwise asks to create, extend, or integrate a Salesforce mobile experience in Swift or Kotlin (MSDK, Agentforce SDK, or both). SKIP when the user is building a non-Salesforce mobile app, using React Native / Flutter / Ionic without Salesforce integration, asking about generic mobile UI design, or working on a Salesforce-adjacent web/desktop surface (LWC, Experience Cloud, Mobile Publisher branding-only)."
4
- license: Apache-2.0
5
4
  metadata:
6
5
  version: "1.0"
7
6
  ---
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: building-omnistudio-callable-apex
3
3
  description: "Salesforce Industries Common Core (OmniStudio/Vlocity) Apex callable generation and review skill with 120-point scoring. Use when creating, reviewing, or migrating Industries callable Apex implementations. TRIGGER when: user creates or reviews System.Callable classes, migrates VlocityOpenInterface or VlocityOpenInterface2, or builds Industries callable extensions used by OmniStudio, Integration Procedures, or DataRaptors. DO NOT TRIGGER when: generic Apex classes or triggers (use generating-apex), building Integration Procedures (use building-omnistudio-integration-procedure), authoring OmniScripts (use building-omnistudio-omniscript), configuring Data Mappers (use building-omnistudio-datamapper), or analyzing namespace/dependency issues (use analyzing-omnistudio-dependencies)."
4
- license: MIT
5
4
  metadata:
6
5
  version: "1.0"
7
6
  ---
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: building-omnistudio-datamapper
3
3
  description: "OmniStudio Data Mapper (formerly DataRaptor) creation and validation with 100-point scoring. Use when building Extract, Transform, Load, or Turbo Extract Data Mappers, mapping Salesforce object fields, or reviewing existing Data Mapper configurations. TRIGGER when: user creates Data Mappers, configures field mappings, works with OmniDataTransform metadata, or asks about DataRaptor/Data Mapper patterns. DO NOT TRIGGER when: building Integration Procedures (use building-omnistudio-integration-procedure), authoring OmniScripts (use building-omnistudio-omniscript), or analyzing cross-component dependencies (use analyzing-omnistudio-dependencies)."
4
- license: MIT
5
4
  metadata:
6
5
  version: "1.0"
7
6
  ---
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: building-omnistudio-flexcard
3
3
  description: "OmniStudio FlexCard creation and validation with 130-point scoring. Use when building at-a-glance UI cards, configuring data source bindings to Integration Procedures, or reviewing existing FlexCard definitions for accessibility and performance. TRIGGER when: user creates FlexCards, configures data sources, designs card layouts, or asks about OmniUiCard metadata. DO NOT TRIGGER when: building OmniScripts (use building-omnistudio-omniscript), creating Integration Procedures (use building-omnistudio-integration-procedure), or analyzing dependencies (use analyzing-omnistudio-dependencies)."
4
- license: MIT
5
4
  metadata:
6
5
  version: "1.0"
7
6
  ---
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: building-omnistudio-integration-procedure
3
3
  description: "OmniStudio Integration Procedure creation and validation with 110-point scoring. Use this skill when building server-side process orchestrations that combine Data Mapper actions, Apex Remote Actions, HTTP callouts, and conditional logic. TRIGGER when: user creates Integration Procedures, adds Data Mapper steps, configures Remote Actions, or reviews existing IP configurations. DO NOT TRIGGER when: building OmniScripts (use building-omnistudio-omniscript), creating Data Mappers directly (use building-omnistudio-datamapper), or analyzing cross-component dependencies (use analyzing-omnistudio-dependencies)."
4
- license: MIT
5
4
  metadata:
6
5
  version: "1.0"
7
6
  ---
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: building-omnistudio-omniscript
3
3
  description: "OmniStudio OmniScript creation and validation with 120-point scoring. Use when building guided digital experiences, multi-step forms, or interactive processes that orchestrate Integration Procedures and Data Mappers. TRIGGER when: user creates OmniScripts, designs step flows, configures element types, or reviews existing OmniScript configurations. DO NOT TRIGGER when: building FlexCards (use building-omnistudio-flexcard), creating Integration Procedures directly (use building-omnistudio-integration-procedure), or analyzing dependencies (use analyzing-omnistudio-dependencies)."
4
- license: MIT
5
4
  metadata:
6
5
  version: "1.0"
7
6
  ---
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: building-sf-integrations
3
3
  description: "Salesforce integration architecture and runtime plumbing with 120-point scoring. Use this skill to set up Named Credentials, External Credentials, External Services, REST/SOAP callout patterns, Platform Events, and Change Data Capture. TRIGGER when: user sets up Named Credentials, External Services, REST/SOAP callouts, Platform Events, CDC, or touches .namedCredential-meta.xml files. DO NOT TRIGGER when: Connected App/OAuth config (use configuring-connected-apps), Apex-only logic (use generating-apex), or data import/export (use handling-sf-data)."
4
- license: MIT
5
4
  metadata:
6
5
  version: "1.1"
7
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
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: configuring-connected-apps
3
3
  description: "Salesforce Connected Apps and External Client Apps OAuth configuration with 120-point scoring. Use this skill to configure OAuth flows, JWT bearer auth, Connected Apps, and External Client Apps in Salesforce. TRIGGER when: user configures OAuth flows, JWT bearer auth, Connected Apps, ECAs, or touches .connectedApp-meta.xml / .eca-meta.xml files. DO NOT TRIGGER when: configuring Named Credentials for callouts (use building-sf-integrations), reviewing permission policies (use deploying-metadata), or writing Apex token-handling code (use generating-apex)."
4
- license: MIT
5
4
  allowed-tools: Bash Read Write Edit Glob Grep WebFetch AskUserQuestion TodoWrite
6
5
  metadata:
7
6
  version: "1.1"
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: connecting-datacloud
3
3
  description: "Salesforce Data Cloud Connect phase. Use this skill when the user manages Data Cloud connections, connectors, or sets up a new source system. TRIGGER when: user manages Data Cloud connections, connectors, connector metadata, tests a connection, browses source objects or databases, or sets up a new source system. DO NOT TRIGGER when: the task is about data streams or DLOs (use preparing-datacloud), DMOs or identity resolution (use harmonizing-datacloud), retrieval/search (use retrieving-datacloud), or STDM telemetry (use observing-agentforce)."
4
- license: MIT
5
4
  compatibility: "Requires the sf data360 CLI plugin and a Data Cloud-enabled org"
6
5
  metadata:
7
6
  version: "1.0"
@@ -44,7 +43,7 @@ Ask for or infer:
44
43
  ## Core Operating Rules
45
44
 
46
45
  - Verify the plugin runtime first; see [../orchestrating-datacloud/references/plugin-setup.md](../orchestrating-datacloud/references/plugin-setup.md).
47
- - 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`.
48
47
  - Prefer read-only discovery before connection creation.
49
48
  - Suppress linked-plugin warning noise with `2>/dev/null` for standard usage.
50
49
  - Remember that `connection list` requires `--connector-type`.
@@ -60,7 +59,7 @@ Ask for or infer:
60
59
 
61
60
  ### 1. Classify readiness for connect work
62
61
  ```bash
63
- 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
64
63
  ```
65
64
 
66
65
  ### 2. Discover connector types
@@ -1,8 +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
- license: Apache-2.0
6
4
  compatibility: "Requires Commerce licenses, Experience Cloud, Salesforce CLI"
7
5
  metadata:
8
6
  version: "1.0"
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: debugging-apex-logs
3
3
  description: "Salesforce debug log analysis and troubleshooting with 100-point scoring. TRIGGER when: user analyzes debug logs, hits governor limits, reads stack traces, or touches .log files from Salesforce orgs. DO NOT TRIGGER when: running Apex tests (use running-apex-tests), generating or fixing Apex code (use generating-apex), or Agentforce session tracing (use observing-agentforce)."
4
- license: MIT
5
4
  metadata:
6
5
  version: "1.1"
7
6
  ---
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: deploying-metadata
3
3
  description: "Salesforce DevOps automation using sf CLI v2. TRIGGER when: user deploys metadata, creates/manages scratch orgs or sandboxes, sets up CI/CD pipelines, or troubleshoots deployment errors with sf project deploy. DO NOT TRIGGER when: writing Apex code (use generating-apex), building LWC components (use generating-lwc-components), creating metadata definitions (use generating-custom-object or generating-custom-field), or querying org data (use handling-sf-data)."
4
- license: MIT
5
4
  metadata:
6
5
  version: "1.1"
7
6
  ---
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: deploying-omnistudio-datapacks
3
3
  description: "Salesforce Industries DataPack deployment automation using Vlocity Build. TRIGGER when: user deploys or validates OmniStudio/Vlocity DataPacks with vlocity commands (packDeploy/packRetry/packExport/packGetDiffs), sets up DataPack CI/CD pipelines, or troubleshoots DataPack migration errors. DO NOT TRIGGER when: deploying Salesforce metadata with sf project deploy (use deploying-metadata), authoring OmniStudio artifacts (use building-omnistudio-*), or writing Apex/LWC business logic (use generating-apex/generating-lwc-components)."
4
- license: MIT
5
4
  metadata:
6
5
  version: "1.0"
7
6
  ---
@@ -1,11 +1,9 @@
1
1
  ---
2
2
  name: developing-agentforce
3
3
  description: "Build, modify, debug, and deploy agents with Agentforce Agent Script. TRIGGER when: user creates, modifies, or asks about .agent files or aiAuthoringBundle metadata; changes agent behavior, responses, or conversation logic; designs agent actions, tools, subagents, or flow control; writes or reviews an Agent Spec; previews, debugs, deploys, publishes, or tests agents; uses Agent Script CLI commands (sf agent generate/preview/publish/test). DO NOT TRIGGER when: Apex development, Flow building, Prompt Template authoring, Experience Cloud configuration, or general Salesforce CLI tasks unrelated to Agent Script."
4
- license: Apache-2.0
5
4
  compatibility: "Requires Agentforce license, API v66.0+, Einstein Agent User"
6
5
  metadata:
7
6
  version: "1.0"
8
- last_updated: "2026-04-08"
9
7
  ---
10
8
 
11
9
  # Agent Script Skill
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: fetching-salesforce-docs
3
3
  description: "Official Salesforce documentation retrieval skill. Use when you need authoritative Salesforce docs from developer.salesforce.com, help.salesforce.com, architect.salesforce.com, admin.salesforce.com, or lightningdesignsystem.com, especially when pages are JS-heavy, shell-rendered, or hard to extract with naive fetching. Use to ground answers in official Salesforce sources instead of third-party blogs or summaries. TRIGGER when: user asks for official Salesforce documentation, Apex or API reference, LWC docs, Agentforce docs, setup or help articles, or any doc from a Salesforce-owned domain. DO NOT TRIGGER when: user is asking for a code change, deployment task, or anything not requiring documentation retrieval — use the appropriate sf-* skill instead."
4
- license: MIT
5
4
  metadata:
6
5
  version: "1.1"
7
6
  ---
@@ -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
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: generating-lwc-components
3
3
  description: "Lightning Web Components with PICKLES methodology and 165-point scoring. Use this skill when the user creates or edits LWC components, builds wire service patterns, or writes Jest tests for LWC. TRIGGER when: user creates/edits LWC components, touches lwc/**/*.js, .html, .css, .js-meta.xml files, or asks about wire service, SLDS, or Jest LWC tests. DO NOT TRIGGER when: Apex classes (use generating-apex), Aura components, or Visualforce."
4
- license: MIT
5
4
  metadata:
6
5
  version: "1.1"
7
6
  ---
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: generating-mermaid-diagrams
3
3
  description: "Salesforce architecture diagrams using Mermaid with ASCII fallback. Use this skill when generating text-based diagrams for Salesforce architecture, OAuth flows, ERDs, integration sequences, or Agentforce structure. TRIGGER when: user says \"diagram\", \"visualize\", \"ERD\", or asks for sequence diagrams, flowcharts, class diagrams, or architecture visualizations in Mermaid. DO NOT TRIGGER when: user wants PNG/SVG image output (use generating-visual-diagrams), or asks about non-Salesforce systems."
4
- license: MIT
5
4
  compatibility: "Requires Mermaid-capable renderer for diagram previews"
6
5
  metadata:
7
6
  version: "1.0"
@@ -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
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: generating-visual-diagrams
3
3
  description: "AI-powered image generation for Salesforce visuals via Nano Banana Pro. Use this skill when the user needs rendered PNG/SVG output such as visual ERDs (Entity Relationship Diagrams), UI mockups, wireframes, or architecture illustrations. TRIGGER when: user asks for PNG/SVG output, UI mockups, wireframes, visual ERDs, or says \"generate image\" / \"create mockup\". DO NOT TRIGGER when: text-based Mermaid diagrams (use generating-mermaid-diagrams), or non-visual documentation tasks."
4
- license: MIT
5
4
  metadata:
6
5
  version: "1.0"
7
6
  ---
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: handling-sf-data
3
3
  description: "Salesforce data operations with 130-point scoring. Use this skill to create, update, delete, bulk import/export, generate test data, and clean up org records using sf CLI and anonymous Apex. TRIGGER when: user creates test data, performs bulk import/export, uses sf data CLI commands, needs data factory patterns for Apex tests, or needs to seed/clean records in a Salesforce org. DO NOT TRIGGER when: SOQL query writing only (use querying-soql), Apex test execution (use running-apex-tests), or metadata deployment (use deploying-metadata)."
4
- license: MIT
5
4
  metadata:
6
5
  version: "1.1"
7
6
  ---
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: harmonizing-datacloud
3
3
  description: "Salesforce Data Cloud Harmonize phase. Use this skill when the user works with DMOs, mappings, relationships, identity resolution, unified profiles, data graphs, or universal IDs. TRIGGER when: user works with DMOs, mappings, relationships, identity resolution, unified profiles, data graphs, or universal IDs. DO NOT TRIGGER when: the task is only about streams/DLOs (use preparing-datacloud), segments/insights (use segmenting-datacloud), retrieval/search (use retrieving-datacloud), or STDM/session tracing (use observing-agentforce)."
4
- license: MIT
5
4
  compatibility: "Requires an external community sf data360 CLI plugin and a Data Cloud-enabled org"
6
5
  metadata:
7
6
  version: "1.0"
@@ -41,7 +40,7 @@ Ask for or infer:
41
40
  ## Core Operating Rules
42
41
 
43
42
  - Inspect DMO schema before creating mappings.
44
- - 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`.
45
44
  - Prefer `dmo list --all` when browsing the catalog, but use first-page `dmo list` for fast readiness checks.
46
45
  - Use `query describe` or `dmo get --json` instead of inventing unsupported describe flows.
47
46
  - Treat identity resolution runs as asynchronous and verify results after execution.
@@ -53,7 +52,7 @@ Ask for or infer:
53
52
 
54
53
  ### 1. Classify readiness for harmonize work
55
54
  ```bash
56
- 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
57
56
  ```
58
57
 
59
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,7 +1,6 @@
1
1
  ---
2
2
  name: integrating-b2b-commerce-open-code-components
3
3
  description: "Integrate Salesforce B2B Commerce open source components from GitHub into B2B Commerce stores. Use when users mention \"integrate open code components\", \"open source B2B commerce\", \"add open code components\", \"forcedotcom/b2b-commerce-open-source-components\", or want to add open source commerce components to their store. Copies all components and labels so they become available in Experience Builder."
4
- license: LICENSE.txt has complete terms
5
4
  allowed-tools: Bash(git clone:*) Bash(cp:*) Read
6
5
  metadata:
7
6
  version: "1.0"
@@ -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
  ---
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: modeling-omnistudio-epc-catalog
3
3
  description: "Salesforce Industries CME EPC product-modeling skill for Product2-based catalog creation. Use when creating EPC products, configuring product attributes, building offer bundles with Product Child Items, or reviewing EPC DataPack JSON metadata for product catalog changes. TRIGGER when: user creates or updates Product2 EPC records, AttributeAssignment payloads, AttributeMetadata/AttributeDefaultValues, Offer bundles, or ProductChildItem relationships. DO NOT TRIGGER when: designing OmniScripts/FlexCards/Integration Procedures (use building-omnistudio-omniscript, building-omnistudio-flexcard, or building-omnistudio-integration-procedure), implementing Apex business logic (use generating-apex), or troubleshooting deployment pipelines (use deploying-metadata)."
4
- license: MIT
5
4
  metadata:
6
5
  version: "1.0"
7
6
  ---
@@ -2,10 +2,8 @@
2
2
  name: observing-agentforce
3
3
  description: "Analyze production Agentforce agent behavior using session traces and Data Cloud. TRIGGER when: user queries STDM session data or Data Cloud trace records; investigates production agent failures, regressions, or performance issues; asks about session traces, conversation logs, or agent metrics; wants to reproduce a reported production issue in preview; runs findSessions or trace analysis queries. DO NOT TRIGGER when: user creates, modifies, or debugs .agent files during development (use developing-agentforce); writes or runs test specs (use testing-agentforce); uses sf agent preview for local development iteration; deploys or publishes agents."
4
4
  allowed-tools: Bash Read Write Edit Glob Grep
5
- license: Apache-2.0
6
5
  metadata:
7
6
  version: "1.0"
8
- last_updated: "2026-04-08"
9
7
  argument-hint: "<org-alias> [--agent-file <path>] [--session-id <id>] [--days <n>]"
10
8
  compatibility: claude-code
11
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
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: orchestrating-datacloud
3
3
  description: "Salesforce Data Cloud product orchestrator for connect→prepare→harmonize→segment→act workflows. Use this skill when the user needs a multi-step Data Cloud pipeline, cross-phase troubleshooting, or data space and data kit management. TRIGGER when: user needs a multi-step Data Cloud pipeline, asks to set up or troubleshoot Data Cloud across phases, manages data spaces or data kits, or wants a cross-phase sf data360 workflow. DO NOT TRIGGER when: work is isolated to a single phase (use the matching phase-specific skill), the task is STDM/session tracing/parquet telemetry (use observing-agentforce), standard CRM SOQL (use querying-soql), or Apex implementation (use generating-apex)."
4
- license: MIT
5
4
  compatibility: "Requires an external community sf data360 CLI plugin and a Data Cloud-enabled org"
6
5
  metadata:
7
6
  version: "1.0"
@@ -93,7 +92,7 @@ Recommended checks:
93
92
  ```bash
94
93
  sf data360 man
95
94
  sf org display -o <alias>
96
- bash ~/.claude/skills/orchestrating-datacloud/scripts/verify-plugin.sh <alias>
95
+ bash ./scripts/verify-plugin.sh <alias>
97
96
  ```
98
97
 
99
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.
@@ -101,12 +100,12 @@ Treat `sf data360 doctor` as a broad health signal, not the sole gate. On partia
101
100
  ### 2. Classify readiness before changing anything
102
101
  Run the shared classifier first:
103
102
  ```bash
104
- node ~/.claude/skills/orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --json
103
+ node ./scripts/diagnose-org.mjs -o <org> --json
105
104
  ```
106
105
 
107
106
  Only use a query-plane probe after you know the table name is real:
108
107
  ```bash
109
- 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
110
109
  ```
111
110
 
112
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
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: preparing-datacloud
3
3
  description: "Salesforce Data Cloud Prepare phase. Use this skill when the user creates or manages Data Cloud data streams, DLOs, transforms, or Document AI configurations. TRIGGER when: user creates or manages Data Cloud data streams, DLOs, transforms, or Document AI configurations, or asks about ingestion into Data Cloud. DO NOT TRIGGER when: the task is connection setup only (use connecting-datacloud), DMOs and identity resolution (use harmonizing-datacloud), or query/search work (use retrieving-datacloud)."
4
- license: MIT
5
4
  compatibility: "Requires an external community sf data360 CLI plugin and a Data Cloud-enabled org"
6
5
  metadata:
7
6
  version: "1.0"
@@ -45,7 +44,7 @@ Ask for or infer:
45
44
  ## Core Operating Rules
46
45
 
47
46
  - Verify the external plugin runtime before running Data Cloud commands.
48
- - 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`.
49
48
  - Prefer inspecting existing streams and DLOs before creating new ingestion assets.
50
49
  - Suppress linked-plugin warning noise with `2>/dev/null` for normal usage.
51
50
  - Treat DLO naming and field naming as Data Cloud-specific, not CRM-native.
@@ -60,7 +59,7 @@ Ask for or infer:
60
59
 
61
60
  ### 1. Classify readiness for prepare work
62
61
  ```bash
63
- 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
64
63
  ```
65
64
 
66
65
  ### 2. Inspect existing ingestion assets
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: querying-soql
3
3
  description: "SOQL query generation, optimization, and analysis with 100-point scoring. Use this skill when the user needs SOQL/SOSL authoring or optimization: natural-language-to-query generation, relationship queries, aggregates, query-plan analysis, and performance or safety improvements for Salesforce queries. TRIGGER when: user writes, optimizes, or debugs SOQL/SOSL queries, touches .soql files, or asks about relationship queries, aggregates, or query performance. DO NOT TRIGGER when: bulk data operations (use handling-sf-data), Apex DML logic (use generating-apex), or report/dashboard queries."
4
- license: MIT
5
4
  metadata:
6
5
  version: "1.1"
7
6
  ---
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: retrieving-datacloud
3
3
  description: "Salesforce Data Cloud Retrieve phase. Use this skill when the user runs Data Cloud SQL, async queries, vector search, search-index workflows, or metadata introspection for Data Cloud objects. TRIGGER when: user runs Data Cloud SQL, describe, async queries, vector search, search-index workflows, or metadata introspection for Data Cloud objects. DO NOT TRIGGER when: the task is standard CRM SOQL (use querying-soql), segment creation or calculated insight design (use segmenting-datacloud), or STDM/session tracing/parquet analysis (use observing-agentforce)."
4
- license: MIT
5
4
  compatibility: "Requires an external community sf data360 CLI plugin and a Data Cloud-enabled org"
6
5
  metadata:
7
6
  version: "1.0"
@@ -40,7 +39,7 @@ Ask for or infer:
40
39
  ## Core Operating Rules
41
40
 
42
41
  - Treat Data Cloud SQL as its own query language, not SOQL.
43
- - 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`.
44
43
  - Use describe before guessing columns.
45
44
  - Prefer `sqlv2` or async query flows for larger result sets.
46
45
  - Use vector search or hybrid search only when the search index lifecycle is healthy.
@@ -52,9 +51,9 @@ Ask for or infer:
52
51
 
53
52
  ### 1. Classify readiness for retrieve work
54
53
  ```bash
55
- 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
56
55
  # optional query-plane probe, only with a real table name
57
- 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
58
57
  ```
59
58
 
60
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
 
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: running-apex-tests
3
3
  description: "Apex test execution, coverage analysis, and test-fix loops with 120-point scoring. Use when the user needs to run Apex tests, check code coverage, fix failing tests, or work with *Test.cls / *_Test.cls files. TRIGGER when: user runs Apex tests, checks code coverage, fixes failing tests, or touches *Test.cls / *_Test.cls files. DO NOT TRIGGER when: writing Apex production code (use generating-apex), Agentforce agent testing (use testing-agentforce), or Jest/LWC tests (use generating-lwc-components)."
4
- license: MIT
5
4
  metadata:
6
5
  version: "1.1"
7
6
  ---
@@ -2,7 +2,6 @@
2
2
  name: running-code-analyzer
3
3
  description: "Run Salesforce Code Analyzer to scan code for security, performance, best practice, and code style violations. Supports all engines (PMD, ESLint, CPD, RetireJS, Flow, SFGE, ApexGuru), targets (files, folders, git diff), categories, and severities. TRIGGER when: user says 'scan my code', 'check for security issues', 'run PMD/ESLint', 'find duplicates', 'analyze Flows', 'check vulnerable libraries', 'AppExchange review', 'lint my LWC', 'static analysis', 'code quality', or mentions engines/file types (.cls, .trigger, .js, .flow-meta.xml). DO NOT TRIGGER when: user wants to fix code without scanning, or asks about installation/configuration."
4
4
  allowed-tools: Read, Bash(sf code-analyzer), Bash(node), Bash(git diff), Bash(date), Write, Edit
5
- license: LICENSE.txt has complete terms
6
5
  metadata:
7
6
  version: "1.0"
8
7
  argument-hint: "[target-path] [--engine pmd|eslint|cpd|retire-js|regex|flow|sfge|apexguru] [--category Security|Performance|BestPractices|...] [--severity 1-5] [--diff]"
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: segmenting-datacloud
3
3
  description: "Salesforce Data Cloud Segment phase. Use this skill when the user creates or publishes segments, manages calculated insights, or troubleshoots audience SQL in Data Cloud. TRIGGER when: user creates or publishes segments, manages calculated insights, inspects segment counts or membership, or troubleshoots audience SQL in Data Cloud. DO NOT TRIGGER when: the task is DMO/mapping/identity-resolution work (use harmonizing-datacloud), activation work (use activating-datacloud), query/search-index work (use retrieving-datacloud), or Standard Data Model (STDM)/session tracing (use observing-agentforce)."
4
- license: MIT
5
4
  compatibility: "Requires an external community sf data360 CLI plugin and a Data Cloud-enabled org"
6
5
  metadata:
7
6
  version: "1.0"
@@ -2,10 +2,8 @@
2
2
  name: testing-agentforce
3
3
  description: "Write, run, and analyze structured test suites for Agentforce agents. TRIGGER when: user writes or modifies test spec YAML (AiEvaluationDefinition); runs sf agent test create, run, run-eval, or results commands; asks about test coverage strategy, metric selection, or custom evaluations; interprets test results or diagnoses test failures; asks about batch testing, regression suites, or CI/CD test integration. DO NOT TRIGGER when: user creates, modifies, previews, or debugs .agent files (use developing-agentforce); deploys or publishes agents; writes Agent Script code; uses sf agent preview for development iteration; analyzes production session traces (use observing-agentforce)."
4
4
  allowed-tools: Bash Read Write Edit Glob Grep
5
- license: Apache-2.0
6
5
  metadata:
7
6
  version: "1.0"
8
- last_updated: "2026-04-08"
9
7
  argument-hint: "<org-alias> --authoring-bundle <AgentName> [--utterances <file>] | run <org> --target <flow://Name>"
10
8
  compatibility: claude-code
11
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