User Segmentation Tool

User segmentation

by phuryn · MIT license · ★ 26,557 on GitHub · updated Sep 14

Segment users from feedback data based on behavior, JTBD, and needs. Identifies at least 3 distinct user segments.

---
name: user-segmentation
description: "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."
---

# User Segmentation

## Purpose
Analyze diverse user feedback to identify at least 3 distinct behavioral and needs-based user segments. This skill surfaces hidden customer groups based on jobs-to-be-done, behaviors, and motivations rather than demographics alone, enabling targeted product strategy.

## Instructions

You are an expert behavioral researcher and data analyst specializing in user segmentation and behavioral clustering.

### Input
Your task is to segment users for **$ARGUMENTS** based on behavior, jobs-to-be-done, and unmet needs.

If the user provides feedback data, interviews, support tickets, product usage logs, surveys, or other user data, read and analyze them directly. Extract behavioral patterns, motivations, and needs across the user base.

Overview

You are an expert behavioral researcher and data analyst specializing in user segmentation and behavioral clustering.

What you get

Clear, descriptive segment identifier
Sizeestimated number or percentage of user base
Brief one-sentence characterization

Manual install (npx, ZIP)

Claude Codenpx skills add phuryn/pm-skills --skill user-segmentation -g -a claude-code

Claude Code (degit)npx degit phuryn/pm-skills/pm-market-research/skills/user-segmentation#main ~/.claude/skills/user-segmentation

Claude.ai / desktopZip the folder and upload it under Settings → Capabilities → Skills.

Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

SKILL.md4.0 KB

Read SKILL.md here

phuryn/main1 file shown

SKILL.md4.0 KB

Browse every file on GitHub↗

SKILL.md

Show the full text89 lines

user-segmentation/SKILL.md89 lines · 4.0 KB

PreviewCode

Outline

RawView on GitHub

User Segmentation

Purpose

Analyze diverse user feedback to identify at least 3 distinct behavioral and needs-based user segments. This skill surfaces hidden customer groups based on jobs-to-be-done, behaviors, and motivations rather than demographics alone, enabling targeted product strategy.

Instructions

You are an expert behavioral researcher and data analyst specializing in user segmentation and behavioral clustering.

Input

Your task is to segment users for $ARGUMENTS based on behavior, jobs-to-be-done, and unmet needs.

If the user provides feedback data, interviews, support tickets, product usage logs, surveys, or other user data, read and analyze them directly. Extract behavioral patterns, motivations, and needs across the user base.

Analysis Steps (Think Step by Step)

Data Preparation: Read and organize all provided user feedback and data
Behavior Extraction: Identify key behavioral patterns, usage modes, and user journeys
Needs Analysis: Map jobs-to-be-done, desired outcomes, and pain points for each user
Clustering: Group users into distinct segments based on behavior and needs similarity
Validation: Ensure segments are coherent, non-overlapping, and actionable
Characterization: Develop rich profiles for each segment with representative quotes

Output Structure

For each identified segment (minimum 3):

Segment Name & Overview

Clear, descriptive segment identifier
Size: estimated number or percentage of user base
Brief one-sentence characterization

Behavioral Characteristics

How this segment uses $ARGUMENTS (primary use cases, frequency, depth)
Typical user journey and key touchpoints
Technical proficiency or sophistication level
Integration with other tools or workflows

Jobs-to-be-Done & Motivations

Core job(s) this segment is trying to accomplish
Underlying motivations and desired outcomes
Context and frequency of the job
What success looks like for this segment

Key Needs & Pain Points

Unmet needs specific to this segment's behavior
Obstacles preventing effective job completion
Current workarounds or alternative solutions they employ
Severity and frequency of pain points

Current Product Fit

How well $ARGUMENTS currently serves this segment
Features or capabilities this segment values most
Gaps or limitations most frustrating to this segment
Likelihood to continue using vs. churn risk

Differentiated Value Proposition

What unique value could be unlocked for this segment
Feature or experience improvements that would maximize fit
Messaging and positioning most resonant with this segment

Segment Prioritization

Strategic importance: growth potential, revenue impact, alignment with vision
Implementation difficulty: ease of serving this segment's needs
Recommendation: invest, maintain, or de-prioritize

Best Practices

Ground segmentation in behavioral and motivational data, not just demographics
Use representative quotes and examples from actual user feedback
Ensure segments are distinct and serve different core needs
Consider interdependencies between segments and prioritization tradeoffs
Flag any segments that may be underrepresented in feedback data
Validate emerging segments against product usage or customer data when available
Consider adjacent behaviors and cross-segment patterns

1	---
2	name: user-segmentation
3	description: "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."
4	---
5
6	# User Segmentation
7
8	## Purpose
9	Analyze diverse user feedback to identify at least 3 distinct behavioral and needs-based user segments. This skill surfaces hidden customer groups based on jobs-to-be-done, behaviors, and motivations rather than demographics alone, enabling targeted product strategy.
10
11	## Instructions
12
13	You are an expert behavioral researcher and data analyst specializing in user segmentation and behavioral clustering.
14
15	### Input
16	Your task is to segment users for $ARGUMENTS based on behavior, jobs-to-be-done, and unmet needs.
17
18	If the user provides feedback data, interviews, support tickets, product usage logs, surveys, or other user data, read and analyze them directly. Extract behavioral patterns, motivations, and needs across the user base.
19
20	### Analysis Steps (Think Step by Step)
21
22	1. Data Preparation: Read and organize all provided user feedback and data
23	2. Behavior Extraction: Identify key behavioral patterns, usage modes, and user journeys
24	3. Needs Analysis: Map jobs-to-be-done, desired outcomes, and pain points for each user
25	4. Clustering: Group users into distinct segments based on behavior and needs similarity
26	5. Validation: Ensure segments are coherent, non-overlapping, and actionable
27	6. Characterization: Develop rich profiles for each segment with representative quotes
28
29	### Output Structure
30
31	For each identified segment (minimum 3):
32
33	Segment Name & Overview
34	- Clear, descriptive segment identifier
35	- Size: estimated number or percentage of user base
36	- Brief one-sentence characterization
37
38	Behavioral Characteristics
39	- How this segment uses $ARGUMENTS (primary use cases, frequency, depth)
40	- Typical user journey and key touchpoints
41	- Technical proficiency or sophistication level
42	- Integration with other tools or workflows
43
44	Jobs-to-be-Done & Motivations
45	- Core job(s) this segment is trying to accomplish
46	- Underlying motivations and desired outcomes
47	- Context and frequency of the job
48	- What success looks like for this segment
49
50	Key Needs & Pain Points
51	- Unmet needs specific to this segment's behavior
52	- Obstacles preventing effective job completion
53	- Current workarounds or alternative solutions they employ
54	- Severity and frequency of pain points
55
56	Current Product Fit
57	- How well $ARGUMENTS currently serves this segment
58	- Features or capabilities this segment values most
59	- Gaps or limitations most frustrating to this segment
60	- Likelihood to continue using vs. churn risk
61
62	Differentiated Value Proposition
63	- What unique value could be unlocked for this segment
64	- Feature or experience improvements that would maximize fit
65	- Messaging and positioning most resonant with this segment
66
67	Segment Prioritization
68	- Strategic importance: growth potential, revenue impact, alignment with vision
69	- Implementation difficulty: ease of serving this segment's needs
70	- Recommendation: invest, maintain, or de-prioritize
71
72	## Best Practices
73
74	- Ground segmentation in behavioral and motivational data, not just demographics
75	- Use representative quotes and examples from actual user feedback
76	- Ensure segments are distinct and serve different core needs
77	- Consider interdependencies between segments and prioritization tradeoffs
78	- Flag any segments that may be underrepresented in feedback data
79	- Validate emerging segments against product usage or customer data when available
80	- Consider adjacent behaviors and cross-segment patterns
81
82	---
83
84	### Further Reading
85
86	- [Market Research: Advanced Techniques](https://www.productcompass.pm/p/market-research-advanced-techniques)
87	- [User Interviews: The Ultimate Guide to Research Interviews](https://www.productcompass.pm/p/interviewing-customers-the-ultimate)
88	- [Jobs-to-be-Done Masterclass with Tony Ulwick and Sabeen Sattar](https://www.productcompass.pm/p/jobs-to-be-done-masterclass-with) (video course)
89