data360-segment

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

Updated Jul 2, 2026
One-click install
npx skills add https://github.com/padjei/SF_Build --skill data360-segment-padjei
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: data360-segment
Source: https://github.com/padjei/SF_Build/tree/main/.claude/skills/data360-segment
Command: npx skills add https://github.com/padjei/SF_Build --skill data360-segment-padjei

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building and debugging audiences in Salesforce Data Cloud involves unfamiliar CLI commands, segment SQL that differs from SOQL, and publish workflows that fail silently. This Skill guides the full segment and calculated-insight lifecycle so you can create, publish, verify, and troubleshoot audience assets without guesswork. ## Core Features & Use Cases - Segment Lifecycle Management: Create segments from reusable JSON definitions, publish them, and verify results with member counts. - Calculated Insight Operations: Create, run, and verify calculated insights against unified Data Model Objects. - Troubleshooting & Verification: Diagnose empty or oversized segments, inspect segment SQL, and run readiness checks before mutating audience assets. - Use Case: You need a high-value customer segment in Data Cloud. The Skill runs an org readiness check, creates the segment from a JSON template with the correct API version, publishes it, and confirms the member count via SQL. ## Quick Start Ask the assistant to create and publish a high-value customer segment in your Data Cloud org and verify its member count.

Frequently Asked Questions about data360-segment

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

FAQPage Schema
How do I create a segment in Salesforce Data Cloud from the CLI?▼

Use sf data360 segment create with a JSON definition file and your org alias, for example sf data360 segment create -o myorg -f segment.json --api-version 64.0. Reusable JSON templates keep segment creation repeatable across orgs.

How do I publish a Data Cloud segment and verify it worked?▼

Run sf data360 segment publish -o <org> --name <Segment_Name>, then verify with sf data360 segment count or a SQL query against the unified DMO. Publish can trigger asynchronous work, so always confirm with counts rather than assuming success.

Why is my Data Cloud segment returning zero members?▼

An empty segment usually means the module is reachable but unconfigured, or the segment SQL filters out all rows. Inspect the segment SQL, check the underlying unified DMO with a COUNT query, and confirm identity resolution and mappings are complete.

Is Data Cloud segment SQL the same as SOQL?▼

No, Data Cloud segment SQL is distinct from CRM SOQL and has its own syntax and limitations. Calculated insight assets and segment SQL also have different constraints, so SOQL patterns should not be assumed to work.

Why does segment creation fail on newer Salesforce API versions?▼

Segment creation behavior can be unstable on newer default API versions. Pass --api-version 64.0 explicitly to the sf data360 segment create command to avoid these failures.

When should I not use this segment workflow?▼

Do not use it for DMO mapping or identity resolution work, which belongs to the harmonize phase, or for activation downstream, which belongs to the activate phase. Read-only SQL and search-index queries belong to the query phase.