Skip to content
Skills Library
Data & analytics · Analysis

segmentation-analysis

/segmentation-analysis

Customer/user segmentation with actionable insights. Use when identifying distinct customer groups, analyzing segment-specific behavior, profiling high-value segments, or testing segmentation hypotheses.

Licence
MIT
Last repository change
25.09.2026

Assessment and security

90/ 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.
Content25 / 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
4
Scripts
1
HTML comments
0
URLs in SKILL.md
0
Deprecation

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

Licence

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

What to check before installing
  • 1 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: scripts/segmentation_runner.py

What it does and when to use it

Customer/user segmentation with actionable insights. Use when identifying distinct customer groups, analyzing segment-specific behavior, profiling high-value segments, or testing segmentation hypotheses.

Original author description

Customer/user segmentation with actionable insights. Use when identifying distinct customer groups, analyzing segment-specific behavior, profiling high-value segments, or testing segmentation hypotheses.

How it works

SKILL.md has no level-two headings · 29 lines, 364 words

SKILL.md preview
---
name: segmentation-analysis
description: Customer/user segmentation with actionable insights. Use when identifying distinct customer groups, analyzing segment-specific behavior, profiling high-value segments, or testing segmentation hypotheses.
---

# Segmentation Analysis

# When to use
- The team needs to understand who the best customers are and what distinguishes them
- Marketing wants distinct groups to target with different messages or offers
- Product needs to prioritise features based on high-value user behaviour patterns
- Churn is high and the team needs to identify at-risk users before they leave
- An existing segmentation feels arbitrary and needs data validation or improvement

# Process
1. **Define the segmentation goal** — clarify what decisions the segments will inform (product roadmap, marketing campaigns, retention programs). The goal determines which variables matter and how many segments are useful (typically 3–7). See `references/segmentation_approaches.md`.
2. **Select and prepare variables** — choose 3–7 attributes or behaviours that vary across users and relate to the business outcome. Handle missing values and scale continuous variables. Remove outliers only if they would distort cluster centroids.
3. **Run the segmentation** — for data-driven segmentation, use k-means clustering via `scripts/segmentation_runner.py`. For rule-based segmentation, apply the business logic rules and validate that segments are distinct and non-overlapping.
4. **Profile each segment** — compute the mean and median for each variable by segment, expressed as % above/below the overall average. Identify the 2–3 defining characteristics of each segment and assign a descriptive name.
5. **Validate and interpret** — confirm segments are meaningfully different (silhouette score > 0.3 for clustering) and make business sense. Sanity-check by asking whether you would actually treat each segment differently.
6. **Map to strategy and report** — assign each segment to a recommended strategy (Retain & Expand, Monetise, Activate, Win-Back, Sunset). Produce `assets/segment_profile_template.md` with the profiles and strategic priorities.

# Inputs the skill needs
- User-level data with attributes (demographics, plan type) and behavioural metrics (sessions, revenue, feature usage, recency)
- Business goal the segmentation will serve
- Any existing segmentation to validate or replace
- Minimum of ~100 users per expected segment for clustering to be meaningful

# Output
- `scripts/segmentation_runner.py` — runs k-means clustering, produces elbow and silhouette plots, assigns segment labels
- `references/segmentation_approaches.md` — when to use k-means vs. RFM vs. rule-based; interpretation guide
- `assets/segment_profile_template.md` — filled segment profiles with size, key characteristics, recommended strategy, and tracking plan
Files in this package (4)
  • SKILL.md 3 KB
  • assets/segment_profile_template.md 2 KB
  • references/segmentation_approaches.md 3 KB
  • scripts/segmentation_runner.py 6 KB

Versions

The database has no other skills named segmentation-analysis.

Identical content appears in 1 other GitHub folders. We show one copy with the highest score.

Database snapshot: 13.11.2026 · package version 571042856bd3 (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

  • 90customer-segments
    Creates customer and user segment documents. Use when the user wants to 'segment customers,' 'customer segments,' 'user segments,' 'lifecycle segments,' or 'audience segmentation.
  • 100customer-segmentation
    Segments customers using RFM scoring, behavioral clustering, or needs-based research, validates the segments, and writes actionable segment profiles. Use when targeting campaigns, designing lifecycle programs, prioritizing markets or personas, or explaining differences in value…
  • 95user-segmentation
    Segment users from feedback data based on behavior, JTBD, and needs. Identifies at least 3 distinct user segments. Use when segmenting a user base, analyzing diverse user feedback, or building a segmentation model.
  • 100customer-segmentation-rfm
    Scores every buyer by RFM from Shopify, WooCommerce, Magento, BigQuery or CSV orders, names segments with revenue shares, and sets each segment's offer and email frequency. Use when asked for RFM analysis, customer segments, email list segmentation or who the best buyers are.
  • 90segmentation-framework
    Use to design and document customer segments with clear criteria, metrics, and governance.
  • 100user-segmentation
    Unified segmentation skill with three modes: market segmentation (identify 3-5 opportunity segments with JTBD and fit analysis), user segmentation (cluster existing users from feedback data by behavior and needs), or beachhead selection (evaluate candidate segments against…

Feedback and reports

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