Skip to content
cccskills
FreePublished on GitHub

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.

The English summary is being prepared. Showing the original description.

See how to install

Files included (4)

  • SKILL.md2.8 KB
  • assets/segment_profile_template.md1.7 KB
  • references/segmentation_approaches.md2.8 KB
  • scripts/segmentation_runner.py6.1 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Rigorous A/B test statistical analysis. Use when analyzing experiment results, calculating statistical significance, checking for sample ratio mismatch, or validating test design before launch.

The English summary is being prepared. Showing the original description.

nimrodfisher/data-analytics-skills481Updated Sep 25, 2026

Track and document analytical assumptions and decisions. Use when making analytical choices, documenting trade-offs, ensuring transparency, or creating audit trails for analytical work.

The English summary is being prepared. Showing the original description.

nimrodfisher/data-analytics-skills481Updated Sep 25, 2026

Structured, reproducible analysis documentation. Use when documenting analysis findings, creating analysis notebooks, ensuring reproducibility, or building analysis archives for future reference.

The English summary is being prepared. Showing the original description.

nimrodfisher/data-analytics-skills481Updated Sep 25, 2026

Structure analysis approach before starting work. Use when receiving new analysis requests, breaking down complex questions into steps, or planning iterative analysis workflows.

The English summary is being prepared. Showing the original description.

nimrodfisher/data-analytics-skills481Updated Sep 25, 2026

Pre-delivery quality assurance for analysis work. Use when reviewing analysis before sharing with stakeholders, checking for completeness, validating assumptions, or ensuring clarity of recommendations.

The English summary is being prepared. Showing the original description.

nimrodfisher/data-analytics-skills481Updated Sep 25, 2026

Post-analysis learning and process improvement. Use when completing major analysis projects, documenting lessons learned, or improving team analytical practices.

The English summary is being prepared. Showing the original description.

nimrodfisher/data-analytics-skills481Updated Sep 25, 2026

See all skills by nimrodfisher

Report a problem with this skill