skills.rest
amanpraaj
amanpraajCOMMUNITY
Explore all skills by this author →
GitHub

sf-datacloud-segment

Creates, publishes, and troubleshoots Salesforce Data Cloud segments and calculated insights.

1|Updated May 7, 2026
Search Tags:#sql#audience#salesforce#segment#sf cli#data cloud#calculated insight
One-click install
npx skills add https://github.com/amanpraaj/sf-skill-hub --skill sf-datacloud-segment-amanpraaj
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sf-datacloud-segment
Source: https://github.com/amanpraaj/sf-skill-hub/tree/main/skills/salesforce/sf-datacloud-segment
Command: npx skills add https://github.com/amanpraaj/sf-skill-hub --skill sf-datacloud-segment-amanpraaj

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building and debugging audiences in Salesforce Data Cloud involves unfamiliar segment SQL, publish workflows, and opaque member counts, and this Skill provides a structured workflow for creating, publishing, and verifying segments and calculated insights. ## Core Features & Use Cases - Segment Lifecycle Management: Create, publish, list, and count segments using the sf data360 CLI with reusable JSON definitions. - Calculated Insight Execution: Create and run calculated insights, then verify results with counts or SQL queries. - Troubleshooting Guidance: Diagnose empty or oversized segments, opaque member IDs, and API version quirks such as requiring --api-version 64.0. - Use Case: A marketing operations engineer asks why a high-value customer segment returns zero members; the Skill runs a readiness check, inspects the segment SQL, and verifies membership via SQL joins. ## Quick Start Ask the agent to create and publish a high-value customer segment in your Data Cloud org and verify its member count.

Frequently Asked Questions about sf-datacloud-segment

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

FAQPage Schema
How do I create and publish a segment in Salesforce Data Cloud?▼

Create a segment with sf data360 segment create using a reusable JSON definition file, then publish it with sf data360 segment publish. Use --api-version 64.0 if creation behaves unexpectedly on newer defaults, and verify with sf data360 segment count afterward.

Why is my Data Cloud segment returning zero members?▼

Empty segments usually stem from segment SQL issues, which differ from CRM SOQL, or from unconfigured upstream data. Run the readiness classifier first, then inspect the segment SQL and verify membership with SQL joins against unified DMOs.

What is the difference between a segment and a calculated insight in Data Cloud?▼

Segments define audience membership for activation, while calculated insights compute aggregate metrics over unified data. They are managed with separate sf data360 commands and have different SQL limitations and verification approaches.

Does this Skill require any special CLI plugins or org setup?▼

Yes, it requires an external community sf data360 CLI plugin and a Data Cloud-enabled Salesforce org. A readiness diagnostic script should be run before mutating audience assets to confirm the org supports segment operations.

Why does sf data360 segment members return unreadable IDs?▼

The segment members command returns opaque identifiers rather than human-readable details. Use SQL joins against unified DMOs, such as UnifiedssotIndividualMain__dlm, when readable member information is needed.

When should I use a different Data Cloud skill instead of this one?▼

Use sf-datacloud-harmonize for DMO, mapping, and identity resolution work, sf-datacloud-act for downstream activation, and sf-datacloud-retrieve for read-only SQL or search-index queries. This Skill covers only segment and calculated insight workflows.

Related Skills

Explore More Data & Analytics Skills→
forcedotcomforcedotcom
803

harmonizing-datacloud

Harmonize Data Cloud DMO structures, field mappings, and identity resolution workflows.

Official
Intermediate
angryracoonangryracoon

data360-activate

Create and manage Salesforce Data Cloud activations and activation targets.

Community
Intermediate
forcedotcomforcedotcom
803

segmenting-datacloud

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

Official
Intermediate
InverterNetworkInverterNetwork

notion

Manage Notion pages, query databases, and deploy custom workers via CLI or REST API.

Official
Advanced