Skip to content
Skills Library
Data & analytics · Review & audit

segment-inventory

/segment-inventory

Map a Segment workspace's sources, the destinations and warehouses each feeds, tracking plans, and Engage spaces, and flag configuration problems such as disabled sources, orphaned destinations, and sources sending nowhere. Use when the user asks what's in their Segment workspace, for an overview or audit of its setup, or where a source's data goes.

Repository
segment-cli ↗
Licence
MIT
Last repository change
06.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 06.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Map a Segment workspace's sources, the destinations and warehouses each feeds, tracking plans, and Engage spaces, and flag configuration problems such as disabled sources, orphaned destinations, and sources sending nowhere. Use when the user asks what's in their Segment workspace, for an overview or audit of its setup, or where a source's data goes.

Original author description

Map a Segment workspace's sources, the destinations and warehouses each feeds, tracking plans, and Engage spaces, and flag configuration problems such as disabled sources, orphaned destinations, and sources sending nowhere. Use when the user asks what's in their Segment workspace, for an overview or audit of its setup, or where a source's data goes.

How it works

  1. Collect
  2. Analyse
  3. Report
Original SKILL.md headings · 39 lines, 329 words
SKILL.md preview
---
name: segment-inventory
description: Map a Segment workspace's sources, the destinations and warehouses each feeds, tracking plans, and Engage spaces, and flag configuration problems such as disabled sources, orphaned destinations, and sources sending nowhere. Use when the user asks what's in their Segment workspace, for an overview or audit of its setup, or where a source's data goes.
license: MIT
compatibility: Requires the segment CLI (npm install -g csangani/segment-cli), logged in. See the segment-setup skill.
allowed-tools: Bash(segment read *) Bash(segment describe *) Bash(segment search *) Bash(segment auth status) Bash(segment auth status *)
---

# Segment workspace inventory

Build a read-only map of the workspace with the `segment` CLI. This skill never writes to Segment. If the user names a workspace profile, add `--profile NAME` to every command.

## Collect

Run these with your shell tool. They are independent, so you can run them in parallel:

```
segment read getWorkspace
segment read listSources --all --fields id,name,slug,enabled,metadata.name,metadata.categories
segment read listDestinations --all --fields id,name,enabled,sourceId,metadata.name
segment read listWarehouses --all --fields id,enabled,metadata.name
segment read listTrackingPlans --all --fields id,name,type,updatedAt
segment read listSpaces --all --fields id,name,slug
```

For warehouse-to-source links, run `segment read listConnectedSourcesFromWarehouse warehouseId=<id> --all --fields id` for each warehouse. Skip this when there are more than 10 warehouses, and say you skipped it.

Expect exit 1 with HTTP 403/404 from `listTrackingPlans` (needs Protocols) and `listSpaces` (needs Engage). Report those as "feature not enabled or token lacks access", not as failures. Exit 3 means not logged in: follow the segment-setup skill. If output was saved to a file, read the file rather than re-fetching.

## Analyse

Join destinations to sources on `sourceId`. Then flag:

- Sources that are **enabled with no enabled destinations and no warehouse**: data comes in and goes nowhere.
- **Disabled sources** that still have enabled destinations.
- **Disabled destinations**: list them, since they may be intentional.
- Destinations whose `sourceId` matches **no source**: orphaned.
- Many destinations of the same type (`metadata.name`) on one source, which may be duplicates.
- **LIVE tracking plans** and when each was last updated.

## Report

Start with counts: sources (enabled/total), destinations (enabled/total), warehouses, tracking plans, and spaces. Then show a compact tree: source → destinations (type, enabled) → warehouses. For workspaces with more than 40 sources, show the flagged items plus a per-source-type summary instead of the full tree. End with the flagged issues, most important first, each with source and destination names and IDs.

If the user asks to save the report, write it to `segment-inventory.md` in the current directory. Don't include write keys or settings values.

Versions

The database has no other skills named segment-inventory.

Database snapshot: 13.11.2026 · package version f0375c932171 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100segment-api
    Read or change a Twilio Segment workspace through the Segment Public API using the `segment` CLI (github.com/csangani/segment-cli). Use when the user mentions Segment, their Segment workspace, sources, destinations, warehouses, write keys, tracking plans or Protocols, Engage…
  • 100segment
    Skill for working with Twilio Segment as an event-tracking ingestion source. Activates when the user mentions Segment, the Segment Public API, tracking plans, sources, destinations, or event taxonomy in the Segment sense. Uses the Segment Public API directly (no MCP server) — bearer-token REST.
  • 85segment-cdp
    Expert patterns for Segment Customer Data Platform including Analytics.js, server-side tracking, tracking plans with Protocols, identity resolution, destinations configuration, and data governance best practices. Use when: segment, analytics.js, customer data platform, cdp, tracking plan.
  • 100segment-audit-trail
    Summarize recent changes in a Segment workspace from the audit trail (who changed which source, destination, tracking plan, or user, and when), optionally filtered to one resource or time window. Use when the user asks what changed in Segment, who disabled or deleted something,…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.