← Back to Skills Marketplace
Customer Segmentation
by
Jaden's built a claw
· GitHub ↗
· v1.0.0
· MIT-0
110
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install ssa-customer-segmentation
Description
Automatically segment customers into five levels using OKKI CRM data, score them, sync tags safely, and provide lifecycle and value-based strategy recommenda...
Usage Guidance
What to consider before installing/running:
- The code expects OKKI CRM credentials and a config JSON in a path outside the skill (default ../../../xiaoman-okki/api/config.json) and will read a .env file at ../../../.env if present. The registry metadata does not declare these required credentials — assume the skill will look for and use local config files.
- The scripts will write persistent files (data/, logs/) inside the skill and will also write a token cache into the external OKKI_WORKSPACE path. If that external workspace is shared with other tools, this skill could overwrite or add tokens used elsewhere.
- Tag-sync performs remote writes to OKKI (but defaults to dry-run). Actual writes require --confirm; still, token acquisition and API calls will occur when confirmed. Review and test in dry-run mode first.
- The scripts merge and replace customer tag arrays (cus_tag is written as a full list) — that behavior is explicit in the code, so if you want to preserve non-segmentation tags be cautious and inspect the merging logic and backups (script claims it creates backups to data/).
- Recommended actions before running:
- Inspect the OKKI config file (client_id, client_secret, baseUrl) that the scripts will read and ensure it points to an appropriate test workspace.
- Move or provide an isolated OKKI_WORKSPACE and .env for testing so the skill cannot read unrelated credentials from your machine.
- Run only the dry-run modes (collector --dry-run, tag-sync without --confirm) first and review produced data in data/ and logs/.
- Backup any real OKKI workspace api/token.cache and companyEnums before performing a confirmed run.
- If you intend to use this skill, update the skill metadata or code to explicitly declare required env vars/paths (so users know what sensitive data is needed) or modify the paths to point inside the skill workspace.
Given the clear mismatch between declared requirements and what the code actually touches (external .env, external config and token cache), treat this skill as suspicious until you can confirm and isolate the configuration it will read/write.
Capability Analysis
Type: OpenClaw Skill
Name: ssa-customer-segmentation
Version: 1.0.0
The skill bundle is a legitimate tool for OKKI CRM customer segmentation, providing automated data collection, scoring, and tag synchronization. It includes robust safety features such as default dry-run modes, API quota monitoring, rate limiting (500ms intervals), and tag-merging logic to prevent overwriting existing CRM data. While it accesses environment variables and configuration files from parent directories (e.g., `../../../.env`), this behavior is consistent with standard integration patterns for local CRM workspaces, and no evidence of malicious data exfiltration or unauthorized execution was found in scripts like `customer-data-collector.js` or `tag-sync.js`.
Capability Assessment
Purpose & Capability
The skill claims to integrate with OKKI CRM (expected), and its scripts implement collection, scoring, strategy generation, and tag sync (coherent). However, the code expects an external OKKI workspace and config file (defaults to ../../../xiaoman-okki/api/config.json and ../../../.env) and will read/write token caches there. The published metadata lists no required environment variables or credentials — that is inconsistent and misleading.
Instruction Scope
SKILL.md tells the agent to run local scripts, which is consistent, but the scripts themselves load env files outside the skill, resolve environment variables from an external .env, read OKKI config from another workspace, and write token cache and logs there. They also call OKKI APIs to create/replace tags. These file reads/writes and cross-workspace accesses are broader than the simple 'run scripts' instructions imply.
Install Mechanism
No install spec is present (instruction-only plus included scripts). No network downloads or package installs are performed by an install step, which reduces supply-chain risk. The runtime will execute shipped JS files with Node.js, so the main operational risk comes from the scripts' behavior rather than an installer.
Credentials
The skill requests no credentials in its metadata but the code expects OAuth client_id/client_secret and other OKKI configuration (read from OKKI config JSON and optional .env). It loads a .env file from ../../../.env into process.env if present and will write token cache into the external OKKI_WORKSPACE path — access to these secrets and files should have been declared and limited.
Persistence & Privilege
The skill does write persistent state: it writes data/*.json, logs, and — importantly — writes token cache files into an external OKKI_WORKSPACE api/token.cache. Writing into another workspace's config directory can modify credentials/state used by other tools and is a privilege beyond an isolated skill. The skill does not request 'always: true', but its ability to modify external files increases its blast radius.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install ssa-customer-segmentation - After installation, invoke the skill by name or use
/ssa-customer-segmentation - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: AI-powered customer scoring and segmentation
Metadata
Frequently Asked Questions
What is Customer Segmentation?
Automatically segment customers into five levels using OKKI CRM data, score them, sync tags safely, and provide lifecycle and value-based strategy recommenda... It is an AI Agent Skill for Claude Code / OpenClaw, with 110 downloads so far.
How do I install Customer Segmentation?
Run "/install ssa-customer-segmentation" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Customer Segmentation free?
Yes, Customer Segmentation is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Customer Segmentation support?
Customer Segmentation is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Customer Segmentation?
It is built and maintained by Jaden's built a claw (@cjboy007); the current version is v1.0.0.
More Skills