segmenting-datacloud

Create, publish, and validate Salesforce Data Cloud segments and calculated insights.

803|289|Updated Nov 7, 2025

Search Tags:#troubleshooting #segments #data cloud #calculated insights #audience SQL #publish workflows #member counts

Ready to run

npx skills add https://github.com/forcedotcom/sf-skills --skill segmenting-datacloud

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: segmenting-datacloud
Source: https://github.com/forcedotcom/sf-skills/tree/main/skills/segmenting-datacloud
Command: npx skills add https://github.com/forcedotcom/sf-skills --skill segmenting-datacloud

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Segmenting-datacloud helps users successfully create, publish, and troubleshoot Salesforce Data Cloud audiences and calculated insights when segment results are empty, unexpectedly large, or SQL behavior is confusing.

Core Features & Use Cases

Segment and calculated insight lifecycle: Create, publish, run, and inspect segments and calculated insights with clear verification steps.
Member count and SQL troubleshooting: Diagnose why segment SQL returns zero members or unexpected counts, using Data Cloud–specific tooling rather than CRM SOQL assumptions.
Guardrails for the right workflow phase: Delegates identity/modeling/activation/search work to other Data Cloud skills to reduce missteps.

Quick Start

Ask the AI to create or publish your Data Cloud segment and verify it by checking the segment count and, if needed, inspecting the underlying segment SQL with the shared readiness classifier.

Frequently Asked Questions about segmenting-datacloud

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

Why does my Data Cloud segment return zero members when I publish it?▼

Data Cloud segments can return zero members due to calculated insight misconfigurations or audience SQL behavior. Diagnose the failure by inspecting the underlying segment SQL and verifying member counts rather than assuming the publish workflow succeeded.

How do I create and publish a Data Cloud segment with correct member counts?▼

Create and publish Data Cloud segments by following the segment lifecycle steps, then validate outcomes by inspecting member counts. Run the orchestrating-datacloud readiness classifier before mutating audience assets to ensure accurate segment results.

Is Data Cloud segment SQL the same as Salesforce SOQL for querying audiences?▼

Data Cloud segment SQL is distinct from CRM SOQL and requires Data Cloud-specific tooling for troubleshooting. Treat segment SQL as a separate query mechanism to avoid missteps when diagnosing unexpected audience results or member counts.

What is the best way to troubleshoot empty or unexpectedly large Data Cloud segments?▼

The best way to troubleshoot Data Cloud segment size issues is to inspect the underlying segment SQL and calculated insights. Verify outcomes via member counts and use the readiness classifier to guide debugging rather than relying on CRM SOQL assumptions.

Do I need a readiness classifier before modifying Data Cloud audience assets?▼

Yes, you must use the orchestrating-datacloud readiness classifier before mutating Data Cloud audience assets. This prerequisite ensures proper workflow phase identification and delegates identity, modeling, or activation work to appropriate Data Cloud skills to reduce missteps.

Can I use this approach to debug calculated insights alongside Data Cloud segments?▼

Yes, this approach supports calculated insight management including creation, execution, and validation. You can debug calculated insights by inspecting their impact on segment SQL behavior and verifying audience results through member count inspection.