@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.
- package/package.json +1 -1
- package/skills/activating-datacloud/SKILL.md +2 -3
- package/skills/analyzing-omnistudio-dependencies/SKILL.md +1 -2
- package/skills/building-mobile-apps/SKILL.md +0 -1
- package/skills/building-omnistudio-callable-apex/SKILL.md +0 -1
- package/skills/building-omnistudio-datamapper/SKILL.md +0 -1
- package/skills/building-omnistudio-flexcard/SKILL.md +0 -1
- package/skills/building-omnistudio-integration-procedure/SKILL.md +0 -1
- package/skills/building-omnistudio-omniscript/SKILL.md +0 -1
- package/skills/building-sf-integrations/SKILL.md +0 -1
- package/skills/building-ui-bundle-app/SKILL.md +1 -1
- package/skills/configuring-connected-apps/SKILL.md +0 -1
- package/skills/connecting-datacloud/SKILL.md +2 -3
- package/skills/creating-b2b-commerce-store/SKILL.md +0 -2
- package/skills/debugging-apex-logs/SKILL.md +0 -1
- package/skills/deploying-metadata/SKILL.md +0 -1
- package/skills/deploying-omnistudio-datapacks/SKILL.md +0 -1
- package/skills/developing-agentforce/SKILL.md +0 -2
- package/skills/fetching-salesforce-docs/SKILL.md +0 -1
- package/skills/generating-apex/SKILL.md +1 -0
- package/skills/generating-lwc-components/SKILL.md +0 -1
- package/skills/generating-mermaid-diagrams/SKILL.md +0 -1
- package/skills/generating-mermaid-diagrams/assets/datamodel/b2b-commerce-erd.md +1 -1
- package/skills/generating-mermaid-diagrams/assets/datamodel/campaigns-erd.md +1 -1
- package/skills/generating-mermaid-diagrams/assets/datamodel/consent-erd.md +1 -1
- package/skills/generating-mermaid-diagrams/assets/datamodel/files-erd.md +1 -1
- package/skills/generating-mermaid-diagrams/assets/datamodel/forecasting-erd.md +1 -1
- package/skills/generating-mermaid-diagrams/assets/datamodel/fsl-erd.md +1 -1
- package/skills/generating-mermaid-diagrams/assets/datamodel/party-model-erd.md +1 -1
- package/skills/generating-mermaid-diagrams/assets/datamodel/quote-order-erd.md +1 -1
- package/skills/generating-mermaid-diagrams/assets/datamodel/revenue-cloud-erd.md +1 -1
- package/skills/generating-mermaid-diagrams/assets/datamodel/sales-cloud-erd.md +1 -1
- package/skills/generating-mermaid-diagrams/assets/datamodel/salesforce-erd.md +1 -1
- package/skills/generating-mermaid-diagrams/assets/datamodel/scheduler-erd.md +1 -1
- package/skills/generating-mermaid-diagrams/assets/datamodel/service-cloud-erd.md +1 -1
- package/skills/generating-mermaid-diagrams/assets/datamodel/territory-management-erd.md +1 -1
- package/skills/generating-mermaid-diagrams/references/erd-conventions.md +1 -1
- package/skills/generating-mermaid-diagrams/references/preview-guide.md +2 -5
- package/skills/generating-visual-diagrams/SKILL.md +0 -1
- package/skills/handling-sf-data/SKILL.md +0 -1
- package/skills/harmonizing-datacloud/SKILL.md +2 -3
- package/skills/implementing-ui-bundle-agentforce-conversation-client/SKILL.md +1 -2
- package/skills/integrating-b2b-commerce-open-code-components/SKILL.md +0 -1
- package/skills/investigating-agentforce-d360/SKILL.md +1 -1
- package/skills/modeling-omnistudio-epc-catalog/SKILL.md +0 -1
- package/skills/observing-agentforce/SKILL.md +0 -2
- package/skills/observing-agentforce/references/stdm-queries.md +3 -11
- package/skills/orchestrating-datacloud/README.md +5 -7
- package/skills/orchestrating-datacloud/SKILL.md +3 -4
- package/skills/orchestrating-datacloud/references/feature-readiness.md +2 -2
- package/skills/orchestrating-datacloud/references/plugin-setup.md +6 -8
- package/skills/orchestrating-datacloud/scripts/diagnose-org.mjs +1 -1
- package/skills/orchestrating-datacloud/scripts/verify-plugin.sh +2 -2
- package/skills/preparing-datacloud/SKILL.md +2 -3
- package/skills/querying-soql/SKILL.md +0 -1
- package/skills/retrieving-datacloud/SKILL.md +3 -4
- package/skills/reviewing-lwc-mobile-offline/SKILL.md +0 -1
- package/skills/running-apex-tests/SKILL.md +0 -1
- package/skills/running-code-analyzer/SKILL.md +0 -1
- package/skills/segmenting-datacloud/SKILL.md +0 -1
- package/skills/testing-agentforce/SKILL.md +0 -2
- package/skills/using-mobile-native-capabilities/SKILL.md +0 -1
package/package.json
CHANGED
|
@@ -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
|
|
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
|
|
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.
|
|
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.
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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.
|
|
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.
|
|
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
|
|
27
|
-
cp
|
|
26
|
+
# Copy from the skill's apex directory
|
|
27
|
+
cp ../apex/AgentforceOptimizeService.cls \
|
|
28
28
|
<project-root>/force-app/main/default/classes/
|
|
29
|
-
cp
|
|
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
|
|
69
|
+
bash ./scripts/verify-plugin.sh
|
|
72
70
|
# or with an org alias
|
|
73
|
-
bash
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
53
|
-
bash
|
|
54
|
-
node
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
@@ -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
|
---
|