# pm-market-research Capabilities: Complete Market Research Toolkit for Product Managers > Explore pm-market-research capabilities. This toolkit offers seven skills for end-to-end market research, including competitive analysis, user segmentation, and sentiment analysis. - Repository: [Pawel Huryn/pm-skills](https://github.com/phuryn/pm-skills) - Tags: api-reference - Published: 2026-06-29 --- **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`](https://github.com/phuryn/pm-skills/blob/main/pm-market-research/README.md). Each skill lives in its own `skills//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`](https://github.com/phuryn/pm-skills/blob/main/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`](https://github.com/phuryn/pm-skills/blob/main/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`](https://github.com/phuryn/pm-skills/blob/main/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: ```text /research-users ``` Prompts the model to request research data (survey CSV, interview notes, etc.) and then produces personas, segments, and a customer-journey map. ```text /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. ```text /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. ```text /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`](https://github.com/phuryn/pm-skills/blob/main/pm-market-research/README.md) – High-level catalog of skills and commands. - [`pm-market-research/skills/competitor-analysis/SKILL.md`](https://github.com/phuryn/pm-skills/blob/main/pm-market-research/skills/competitor-analysis/SKILL.md) – Detailed competitor-analysis skill definition. - [`pm-market-research/skills/customer-journey-map/SKILL.md`](https://github.com/phuryn/pm-skills/blob/main/pm-market-research/skills/customer-journey-map/SKILL.md) – Logic for building journey maps. - [`pm-market-research/skills/user-personas/SKILL.md`](https://github.com/phuryn/pm-skills/blob/main/pm-market-research/skills/user-personas/SKILL.md) – Persona-creation workflow. - [`pm-market-research/skills/user-segmentation/SKILL.md`](https://github.com/phuryn/pm-skills/blob/main/pm-market-research/skills/user-segmentation/SKILL.md) – Segmentation algorithm and output schema. - [`pm-market-research/commands/research-users.md`](https://github.com/phuryn/pm-skills/blob/main/pm-market-research/commands/research-users.md) – Command that wires the above skills together. - [`pm-market-research/commands/competitive-analysis.md`](https://github.com/phuryn/pm-skills/blob/main/pm-market-research/commands/competitive-analysis.md) – Command exposing the competitor-analysis skill. - [`pm-market-research/commands/analyze-feedback.md`](https://github.com/phuryn/pm-skills/blob/main/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`](https://github.com/phuryn/pm-skills/blob/main/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`](https://github.com/phuryn/pm-skills/blob/main/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`](https://github.com/phuryn/pm-skills/blob/main/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.