pm-market-research Capabilities: Complete Market Research Toolkit for Product Managers

The pm-market-research module delivers seven specialized skills and three orchestration commands that enable end-to-end market research, from competitive analysis and user segmentation to sentiment analysis and market sizing.

The pm-market-research package is a self-contained skill-set within the phuryn/pm-skills ecosystem that equips product managers with systematic market research tools. Organized around reusable skills (knowledge modules) and commands (user-facing entry points), it transforms raw data into structured strategic insights without requiring external tools.

Seven Core Market Research Skills

The repository declares seven core market-research skills in pm-market-research/README.md. Each skill lives in its own skills/<skill-name>/SKILL.md file and specifies inputs, step-by-step analysis logic, and output schemas.

• competitor-analysis – Maps the competitive landscape, cataloging strengths, weaknesses, and differentiation opportunities.
• customer-journey-map – Builds end-to-end journey maps with stages, touchpoints, emotions, and pain points.
• market-segments – Identifies 3-5 target segments, detailing demographics, JTBD (Jobs-to-be-Done), and product-fit.
• market-sizing – Estimates TAM, SAM, and SOM using top-down and bottom-up methodologies.
• sentiment-analysis – Extracts sentiment scores from user feedback and links them to specific segments.
• user-personas – Creates refined personas from research data.
• user-segmentation – Groups users by behavior, JTBD, and needs.

High-Level Command Interface

Three commands expose these skills via slash-syntax interpreted by the pm-skills CLI or chat UI. Each command orchestrates a pipeline of relevant skills.

/pm-market-research:research-users

Defined in pm-market-research/commands/research-users.md, this command takes raw research data (surveys, interview notes, analytics) and sequentially runs user-personas → user-segmentation → market-segments → customer-journey-map to produce a complete research report.

/pm-market-research:competitive-analysis

Defined in pm-market-research/commands/competitive-analysis.md, this command executes the competitor-analysis skill (and optionally market-sizing) to output a structured competitor briefing.

/pm-market-research:analyze-feedback

Defined in pm-market-research/commands/analyze-feedback.md, this command runs sentiment-analysis plus user-segmentation to surface segment-level sentiment trends and actionable insights.

Practical Usage Examples

Invoke these commands directly in the pm-skills chat or CLI:

/research-users

Prompts the model to request research data (survey CSV, interview notes, etc.) and then produces personas, segments, and a customer-journey map.

/research-users B2B project-management tool for agencies — help me understand our users

Runs a full synthesis on the supplied product description (no data file required) and returns a research report with hypothesized personas.

/competitive-analysis "project-management SaaS for remote teams"

Invokes the competitor-analysis skill, returning a structured brief that lists 5 direct competitors, their positioning, strengths, weaknesses, and differentiation opportunities.

/analyze-feedback

Accepts uploaded feedback (CSV, support tickets, NPS comments) and returns a sentiment-analysis-driven segmentation view, highlighting which user groups are most satisfied or frustrated.

Source File Architecture

The capabilities are implemented across declarative skill files and command definitions:

• pm-market-research/README.md – High-level catalog of skills and commands.
• pm-market-research/skills/competitor-analysis/SKILL.md – Detailed competitor-analysis skill definition.
• pm-market-research/skills/customer-journey-map/SKILL.md – Logic for building journey maps.
• pm-market-research/skills/user-personas/SKILL.md – Persona-creation workflow.
• pm-market-research/skills/user-segmentation/SKILL.md – Segmentation algorithm and output schema.
• pm-market-research/commands/research-users.md – Command that wires the above skills together.
• pm-market-research/commands/competitive-analysis.md – Command exposing the competitor-analysis skill.
• pm-market-research/commands/analyze-feedback.md – Command exposing sentiment and segmentation.

Summary

• pm-market-research provides seven specialized skills covering the full research lifecycle from personas to competitive analysis.
• Three high-level commands (/research-users, /competitive-analysis, /analyze-feedback) orchestrate complex skill pipelines through simple slash-syntax.
• Each skill is documented in its own SKILL.md file within the skills/ directory, following a standardized input-process-output format.
• The module supports both data-driven analysis (uploaded CSVs, feedback) and hypothesis generation (product descriptions without raw data).
• All capabilities are self-contained within the phuryn/pm-skills repository, requiring no external market research tools.

Frequently Asked Questions

What data formats does pm-market-research support for input?

The module accepts survey CSVs, interview notes, support tickets, NPS comments, and analytics exports. When using the /research-users command, you can also provide a simple product description to generate hypothesized personas without existing data.

How does the competitor-analysis skill determine which competitors to include?

According to the skill definition in skills/competitor-analysis/SKILL.md, the analysis identifies 5 direct competitors based on the provided product context, evaluating their positioning, strengths, weaknesses, and differentiation opportunities relative to your offering.

Can I use individual skills without running the full command pipelines?

Yes. While the three high-level commands orchestrate multiple skills for convenience, you can invoke individual skills directly by referencing their specific logic in the skills/ directory, as each SKILL.md defines standalone input requirements and output schemas.

What is the difference between user-segmentation and market-segments skills?

user-segmentation groups existing users by behavior, JTBD, and needs using available research data, while market-segments identifies 3-5 broader target segments including demographics and product-fit analysis, typically used for go-to-market strategy rather than existing user base analysis.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}