← Back to Skills Marketplace
Segment
by
aiwithabidi
· GitHub ↗
· v1.0.0
348
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install segment
Description
Segment — manage sources, destinations, events, and tracking plans via Config & Tracking APIs
Usage Guidance
This skill appears to do what it claims: it runs a local Python CLI that calls Segment's APIs at https://api.segmentapis.com. Before installing, note: (1) you must provide SEGMENT_ACCESS_TOKEN (used by the script) and SEGMENT_WRITE_KEY (declared but not referenced by the script) — only give tokens with the minimal necessary permissions; (2) the script will look for credentials in a .env file under WORKSPACE or ~/.openclaw/workspace if the env vars are missing, so avoid storing broad secrets in that file if it's shared; (3) there are no remote installers or hidden endpoints. If you need the declared write key to actually be used, ask the author to clarify or update the script; otherwise the requests will be authenticated with the access token only.
Capability Analysis
Type: OpenClaw Skill
Name: segment
Version: 1.0.0
The skill bundle provides a standard CLI tool for managing Segment sources, destinations, and tracking plans via the official Segment Config API (api.segmentapis.com). The Python script (scripts/segment.py) uses only the standard library and follows expected patterns for credential management and API interaction. While there is a minor discrepancy where the required 'SEGMENT_WRITE_KEY' is defined in the documentation but unused in the code, and tracking endpoints are directed to the Config API base, these appear to be unintentional implementation oversights rather than malicious behavior.
Capability Assessment
Purpose & Capability
Name/description match the included CLI script which calls Segment Config & Tracking APIs. Requested credentials (SEGMENT_ACCESS_TOKEN and SEGMENT_WRITE_KEY) are plausible for Segment usage.
Instruction Scope
SKILL.md tells the agent to run the included Python CLI. The CLI only performs HTTP calls to api.segmentapis.com and prints JSON (or human-readable output). It also attempts to read environment variables and falls back to a .env file in WORKSPACE or ~/.openclaw/workspace which is within expected scope but worth noting because it reads a file on disk to locate credentials.
Install Mechanism
No install spec; this is instruction-only with an included Python script that uses only the stdlib. Nothing is downloaded or written to disk by an installer.
Credentials
The skill requires SEGMENT_ACCESS_TOKEN (used as the Bearer auth header) and SEGMENT_WRITE_KEY (declared but not actually referenced by the script). The script also reads the WORKSPACE env var (undocumented in SKILL.md) to locate a fallback .env file. Reading .env to obtain only the declared variables is expected, but you should be aware it will inspect that file to find credentials.
Persistence & Privilege
always is false and the skill does not modify other skills or agent-wide settings. It does not request permanent elevated privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install segment - After installation, invoke the skill by name or use
/segment - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of the Segment skill.
- Manage Segment sources, destinations, events, and tracking plans via Config and Tracking APIs.
- Python 3.10+ only, no external dependencies required.
- All commands available through a single CLI script: sources, destinations, warehouses, catalogs, tracking plans, events, and more.
- Outputs JSON by default, with an option for human-readable formatting.
- Requires SEGMENT_ACCESS_TOKEN and SEGMENT_WRITE_KEY environment variables.
Metadata
Frequently Asked Questions
What is Segment?
Segment — manage sources, destinations, events, and tracking plans via Config & Tracking APIs. It is an AI Agent Skill for Claude Code / OpenClaw, with 348 downloads so far.
How do I install Segment?
Run "/install segment" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Segment free?
Yes, Segment is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Segment support?
Segment is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Segment?
It is built and maintained by aiwithabidi (@aiwithabidi); the current version is v1.0.0.
More Skills