Skip to main content
skill CX Codex

market-segments · phuryn/product-engineering — Claude Code skill: what it does and how to install

The market-segments Claude Code skill identifies 3–5 customer segments and assesses how well a product fits each one. Run it to explore an audience or evaluate a new market.

MIT ★ 741 updated 2026-11-14

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add phuryn/product-engineering
/plugin install product@product-engineering
Open on GitHub

What market-segments does

The skill maps a product’s addressable market into 3–5 distinct customer groups. For each, it outlines customer jobs, desired outcomes and pain points, then assesses market size, growth prospects, competition and product fit.

Each profile covers customer characteristics, success criteria, cost and time constraints, alternatives and adoption barriers. The skill can analyze supplied research, market studies, customer databases and existing segmentation documents. It gives market-size estimates as percentages or absolute figures when supporting data is available, and flags segments that need more research.

What it helps with

  • separate customer groups by jobs and pain points
  • compare product fit across market segments
  • assess growth potential and competitive pressure
  • choose an audience for further research

Example prompts for the agent

  • Analyze customer segments for our product.
  • Compare audiences in this market by their jobs, pain points and product fit.
  • Assess segment potential and flag areas that need more research.

How to install market-segments

1Plugin marketplace

/plugin marketplace add phuryn/product-engineering
/plugin install product@product-engineering

This installs the whole product plugin with all its skills

2Skills CLI (Vercel)

npx skills add phuryn/product-engineering --skill market-segments -a claude-code

3Manually: put the files in place

~/.claude/skills/market-segments/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/market-segments/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about market-segments

How do I install market-segments in Claude Code?

Add the marketplace with /plugin marketplace add phuryn/product-engineering, then install the plugin with /plugin install product@product-engineering.

What does market-segments do?

It identifies 3–5 customer segments and builds a profile for each, covering customer needs, product fit and competitors. It also assesses market size and growth potential.

How does market-segments distinguish a segment from a demographic group?

Segments should differ in their jobs and pain points, not just demographic traits. The skill checks whether groups are distinct and flags those that need more research.

Source text

SKILL.md · MIT
---
name: market-segments
description: "Exploring customer segments, audiences or new markets: 3-5 segments with their jobs, pains and product fit."
---

# Market segments

## Purpose

**Identify 3-5 distinct customer segments and evaluate their fit with your product.** Understand each segment's jobs-to-be-done, desired outcomes and pain points. Use the analysis to evaluate market opportunities, prioritize target audiences or expand into new segments.

## Instructions

**Work as a strategic market research expert.** Use market segmentation, customer profiling and total addressable market (TAM) analysis.

### Input

**Identify and analyze potential customer segments for $ARGUMENTS.** Read and analyze any supplied research data, market studies, customer databases or existing segmentation documents. Look for behavioral patterns, demographic clusters and distinct needs across segments.

### Analysis steps

1. **Consider the full addressable market for $ARGUMENTS.**
2. **Identify logical segmentation dimensions.** Consider behavioral, demographic, firmographic and needs-based dimensions.
3. **Create 3-5 distinct, non-overlapping customer segments.**
4. **Synthesize each segment's profile and validate its distinctness.**
5. **Evaluate market size, growth potential and competitive intensity per segment.** Think through the analysis step by step.

### Output structure

**Provide a profile with the following sections for each of the 3-5 segments.**

#### Segment name and overview

- Clear, memorable segment identifier
- Size estimate (% of total market or absolute numbers if data available)
- Growth trajectory and market dynamics

#### Key demographics and firmographics

- Core characteristics (age, role, company size, industry, geography, etc.)
- Decision-maker profiles if B2B

#### Jobs-to-be-done

- Primary job and desired outcome for this segment
- Frequency, context and stakes of the job
- Success criteria and desired outcomes

#### Key pain points and obstacles

- Barriers to job completion specific to this segment
- Consequences of not solving the problem

#### Desired gains and success factors

- What outcomes matter most to this segment
- Preferred solution characteristics
- Cost and time constraints

#### Product fit analysis

- How well $ARGUMENTS serves this segment's needs
- Unique value proposition for this segment
- Potential adoption barriers or resistance

#### Competitive landscape

- Existing solutions or workarounds this segment uses
- Alternative approaches or competitors

## Best practices

- **Ensure segments are measurable, accessible and distinct.**
- **Prioritize segments with clear jobs-to-be-done and pain points.**
- **Validate segment assumptions with available data.**
- **Consider both greenfield opportunities and underserved segments.**
- **Flag segments requiring additional market research.**

## How you can tell it worked

Each segment is a group with a distinct job and pain rather than a demographic slice. The owner can say which one to explore first.

© Paweł Huryn · MIT · phuryn/product-engineering

Similar skills

All skills for Marketing and content →

market-segments by other authors comes first.

market-segments phuryn market-segments — a skill for Claude Code and five other AI agents that takes a product name and produces profiles for 3–5 customer segments, covering demographics, JTBD, and product fit. CX Codex +1 3,000installs market-response-modeler BuildWithClaude Community market-response-modeler is a Claude Code command for modeling customer and market reactions to business decisions. It kicks in for work involving audience segments and behavioral forecasts. CX Codex +1 ★ 3,785repo stars product-market-fit-analysis manojbajaj95 product-market-fit-analysis is a Claude Code skill that assesses product-market fit through retention, customer surveys, and demand signals. It helps weigh iteration against scaling. CX Codex +1 251installs Product Strategist daffy0208 Product Strategist is a Claude Code skill for testing product ideas before development. It helps assess demand, choose features, and weigh building a solution against buying one. CX Codex +1 160installs market-research affaan-m market-research is a Claude Code skill that conducts competitive analysis, market sizing, and investor due diligence. It structures findings around decisions and enforces source citations. CX Codex +1 8,100installs market-sizing phuryn market-sizing — a skill for calculating market size using TAM, SAM, and SOM with top-down and bottom-up approaches. Helps validate market opportunity and prepare investor pitches. CX Codex +1 3,200installs market-research-analyst davila7 market-research-analyst — a Claude Code subagent that researches markets, competitors and industry trends using web search. It kicks in when you need to size up a niche before launch or prepare a briefing on key players. CX Codex 851installs

From the same set51

The whole set →
handover This Claude Code skill writes a handover for the next agent session. It checks the project against the files on disk and records verified facts, unfinished work, and a concrete next step. CX Codex +1 ★ 741repo stars intended-vs-implemented The intended-vs-implemented Claude Code skill checks whether code follows documented requirements and spots gaps in access control and data boundaries. It audits AI-built features for security and correctness issues. CX Codex +1 ★ 741repo stars value-proposition This Claude Code skill shapes a value proposition with a six-part JTBD structure. It covers a customer segment, its task, the current approach and alternatives. CX Codex +1 ★ 741repo stars competitor-analysis competitor-analysis — a Claude Code skill for mapping market rivals and product substitutes. It analyzes five direct competitors, flags functional gaps, and highlights strategic differentiation points. CX Codex +1 ★ 741repo stars growth-loops This Claude Code skill evaluates product growth loops. Ask it to compare viral sharing, referrals, collaboration, or user-generated content and map out an implementation plan. CX Codex +1 ★ 741repo stars beachhead-segment The beachhead-segment Claude Code skill scores candidate customer segments and selects a first market to pursue. It weighs customer pain, willingness to pay, winnable share and referral potential. CX Codex +1 ★ 741repo stars retro The retro Claude Code skill reviews session friction and turns verified causes into changes to the agent setup. Start it by name at the end of a session. CX Codex +1 ★ 741repo stars value-curve This Claude Code skill maps a product’s value curve for one customer segment. It compares key needs, competing offers and relative price. CX Codex +1 ★ 741repo stars

Project sponsors

Companies that keep this analytics open