Guide · Agent skill
How to use the Market Segments Analyzer agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
The Market Segments Analyzer is an agent skill that makes an AI agent structure its market analysis around 3-5 distinct customer segments for a product or market you name. It is useful for product managers, founders, marketers and students who want a clear first pass at who to target. By the end of this guide you will know what the skill does, how to install it, how to trigger it with a plain request, and where its output needs checking.
Market Segments Analyzerphuryn/pm-skills · MIT Download the skill Quick start
- 1Download the ZIP. Download the market-segments skill ZIP from this page and unzip it to get the SKILL.md file.
- 2Choose the install location. Place the skill folder in ~/.claude/skills/ for personal use or in .claude/skills/ inside a project for project-only use.
- 3Or upload in the Claude apps. If you use the Claude apps, open Settings, go to Capabilities and upload the skill under Skills.
- 4Name your product or market. Describe the product or market you want to analyze in plain language, such as a product for a specific buyer type.
- 5Attach any research. Add interview notes, surveys or market studies if you have them so the agent can base segments on them.
- 6Review the segments. Compare the 3-5 segments on jobs, pain points and product fit, and note any the agent flags for more research.
- 7Validate with real customers. Turn the hypotheses into interview questions and check size and growth figures against real sources.
What is an agent skill and what does this one do?
An agent skill is a folder containing a SKILL.md file with instructions that an AI agent loads when a request matches the skill's description. This skill's source is a SKILL.md file that tells the agent to act as a market research expert and analyze customer segments for the subject you name.
Once installed, the agent builds its analysis around 3-5 non-overlapping segments. For each segment it covers size, demographics or firmographics, jobs-to-be-done, pain points, desired gains, how well your product fits, and the competition the segment already uses. If you provide research data, customer databases or segmentation documents, the agent reads them and looks for behavioral patterns and distinct needs. It also flags segments that need more research.
- Segment name, overview, size estimate and growth trajectory
- Key demographics and firmographics, including decision-makers for B2B
- Jobs-to-be-done, desired outcomes and success criteria
- Pain points, obstacles and consequences of not solving the problem
- Desired gains, preferred solution traits and cost or time constraints
- Product fit analysis, value proposition and adoption barriers
- Competitive landscape and existing workarounds
Install the market-segments skill
Download the skill ZIP from this page and unzip it. The skill is a folder that contains SKILL.md. Place that folder in one of two locations, depending on how you want to use it.
For a personal install available across your projects, unzip it into ~/.claude/skills/. To limit it to one project, unzip it into the .claude/skills/ folder inside that project.
If you use the Claude apps instead, open Settings, go to Capabilities, and upload the skill under Skills.
- Personal: ~/.claude/skills/
- Single project: .claude/skills/ inside your project folder
- Claude apps: Settings → Capabilities → Skills, then upload
How do you trigger the skill with a natural request?
You do not need a special command. The skill's description tells the agent when to use it: exploring market segments, identifying target audiences, evaluating new markets, or learning how to segment a market. Describe what you want in plain language and name the product or market clearly, because the skill analyzes whatever you name.
Adding your own data helps. If you have interview notes, a survey export or a market study, attach it or point the agent to it so the segments are grounded in evidence rather than general reasoning.
- "Identify the main customer segments for a project management app for freelance designers."
- "Which audiences should we target first for a B2B invoicing tool for small clinics? Analyze 3-5 segments."
- "Evaluate whether the field service market for solar installers is worth entering, using the attached survey results."
- "Help me learn how to segment the online language learning market."
What do the results look like?
Each segment is presented with the same structure, so you can compare them side by side. Use the output to decide which segment to test first, then check the claims against real sources.
The skill asks the agent to size segments as a percentage of the total market, or in absolute numbers if data is available. Treat any size or growth figure the agent gives without a source as a rough estimate to verify.
- Compare segments on pain points and product fit before comparing size
- Note any segment the agent flags as needing more research
- Turn the strongest hypotheses into interview questions
What does the skill need, and is it safe?
The skill lists no requirements. It does not run scripts and does not use the network. The package contains only SKILL.md, so there is no code to execute and no external calls made by the skill itself.
Because the analysis comes from the model's reasoning unless you supply data, the segments are hypotheses. Do not rely on them as verified market figures, and do not treat them as a substitute for speaking with real customers.
- Requires: nothing listed
- Runs scripts: no
- Uses network: no
- Only file: SKILL.md
Tips for better segment analysis
The more specific your starting point, the more useful the segments. Name the product, the problem it solves and the region or buyer type if you know them. Broad prompts tend to produce generic segments.
Ask the agent to challenge its own output. Requests such as flagging weak assumptions or listing which segments need interviews are in line with the skill's best practices, which call for validating assumptions with available data and flagging segments that need more research.
- Give the product name and the problem it solves
- Attach research or customer data where you have it
- Ask which segments need validation before committing budget
- Use the output to write interview guides, not to set final targets
What people use it for
- Product managers choosing which audience to target first for a new feature
- Founders assessing a new market before committing development or investment
- Marketers drafting target audience profiles for a campaign
- Students learning how market segmentation works using a real product example
- Teams preparing interview guides from a list of candidate segments
Frequently asked questions
How do I install the market-segments agent skill?
Download the skill ZIP from this page and unzip it. Put the folder in ~/.claude/skills/ for personal use, or in .claude/skills/ inside a project. In the Claude apps, you can instead upload it under Settings, then Capabilities, then Skills.
Does the market segments skill require anything else to run?
The skill lists no requirements. It runs no scripts and uses no network access, and the package contains only SKILL.md.
Is the market-segments skill free to use?
The skill is published under the MIT licence. Check the repository's licence file for the full terms before reuse.
Can the skill give me verified market size numbers?
No. The skill gives estimates and asks for data, but it does not pull verified market figures. Check any size numbers against real sources before using them.
Can I use this instead of customer interviews?
No. Segments are synthesized from the model's reasoning unless you supply data, so they are hypotheses. Use the output to shape interviews and validate them with real customers.
What if the skill doesn't trigger when I ask for segments?
Check that the SKILL.md file sits directly inside a skills folder in the correct location, then phrase your request around exploring segments, identifying target audiences or evaluating a new market, which match the skill's description.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Use this skill if you want a structured first pass at 3-5 customer segments for a product or market, especially with your own research attached. Pick something else if you need verified market sizing, financial forecasts or a replacement for primary customer research.
Download the skill