Sf Datacloud Segment

# Credits & Acknowledgments

Primary contributor: **Gnanasekaran Thoppae**

This skill is part of the `sf-datacloud-*` family. Shared attribution, upstream source mapping, and maintenance notes live in:
- [../sf-datacloud/CREDITS.md](../sf-datacloud/CREDITS.md)
- [../sf-datacloud/UPSTREAM.md](../sf-datacloud/UPSTREAM.md)


MIT License

Copyright (c) 2024-2025 Jag Valaiyapathy

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.


# sf-datacloud-segment

Audience and insight workflows for Salesforce Data Cloud.

## Use this skill for

- creating and publishing segments
- managing calculated insights
- checking segment counts
- troubleshooting segment SQL
- understanding why a segment is empty or unexpectedly large

## Example requests

```text
"Create a high-value customer segment in Data Cloud"
"Why is my segment returning zero members?"
"Run this calculated insight and help me verify it"
"Show me how to get member counts for this segment"
```

## Common commands

```bash
sf data360 segment list -o myorg 2>/dev/null
sf data360 segment create -o myorg -f segment.json --api-version 64.0 2>/dev/null
sf data360 segment publish -o myorg --name High_Value_Customers 2>/dev/null
sf data360 calculated-insight list -o myorg 2>/dev/null
```

## References

- [SKILL.md](SKILL.md)
- [../sf-datacloud/assets/definitions/calculated-insight.template.json](../sf-datacloud/assets/definitions/calculated-insight.template.json)
- [../sf-datacloud/assets/definitions/segment.template.json](../sf-datacloud/assets/definitions/segment.template.json)
- [CREDITS.md](CREDITS.md)

## License

MIT License - See [LICENSE](LICENSE).


---
name: sf-datacloud-segment
description: >
  Salesforce Data Cloud Segment phase.
  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 sf-datacloud-harmonize),
  activation work (use sf-datacloud-act), query/search-index work (use sf-datacloud-retrieve),
  or STDM/session tracing (use sf-ai-agentforce-observability).
license: MIT
compatibility: "Requires an external community sf data360 CLI plugin and a Data Cloud-enabled org"
metadata:
  version: "1.0.0"
  author: "Gnanasekaran Thoppae"
  phase: "Segment"
---

# sf-datacloud-segment: Data Cloud Segment Phase

Use this skill when the user needs **audience and insight work**: segments, calculated insights, publish workflows, member counts, or troubleshooting Data Cloud segment SQL.

## When This Skill Owns the Task

Use `sf-datacloud-segment` when the work involves:
- `sf data360 segment *`
- `sf data360 calculated-insight *`
- segment publish workflows
- member counts and segment troubleshooting
- calculated insight execution and verification

Delegate elsewhere when the user is:
- still building DMOs, mappings, or identity resolution → [sf-datacloud-harmonize](../sf-datacloud-harmonize/SKILL.md)
- activating a segment downstream → [sf-d