Core Components of the pm-product-discovery Skills: A Complete Guide to the 13 Discovery Modules

The pm-product-discovery skill set comprises 13 self-contained markdown modules that automate the entire product discovery workflow—from ideation and assumption mapping to experiment design and interview synthesis—each invocable via CLI commands in the phuryn/pm-skills repository.

The pm-product-discovery package in the phuryn/pm-skills repository provides product managers with a structured, code-driven approach to discovery. These pm-product-discovery skills are implemented as individual markdown files containing detailed prompt templates and step-by-step instructions, enabling programmatic execution of complex PM workflows through a unified command interface.

The 13 Core pm-product-discovery Skills

The repository organizes 13 distinct skills into logical workflow stages. Each skill resides in its own directory under pm-product-discovery/skills/<skill-name>/ and defines a specific discovery activity.

Ideation and Brainstorming Skills

Four skills handle divergent thinking for both new and existing products:

• brainstorm-ideas-new: Generates fresh feature ideas for new products using multi-perspective ideation (PM, Designer, Engineer viewpoints). Source: pm-product-discovery/skills/brainstorm-ideas-new/SKILL.md.

• brainstorm-ideas-existing: Applies the same multi-perspective approach to enhance already-launched products. Source: pm-product-discovery/skills/brainstorm-ideas-existing/SKILL.md.

• brainstorm-experiments-new: Creates lean-startup "pretotype" experiments to validate assumptions for brand-new product ideas. Source: pm-product-discovery/skills/brainstorm-experiments-new/SKILL.md.

• brainstorm-experiments-existing: Designs experiments to test assumptions for features in existing products. Source: pm-product-discovery/skills/brainstorm-experiments-existing/SKILL.md.

Assumption Risk Management

Three skills focus on identifying and ranking risky assumptions:

• identify-assumptions-new: Surfaces risky assumptions across 8 categories (Value, Usability, Viability, Feasibility, Go-to-Market, Team, etc.) for new products. Source: pm-product-discovery/skills/identify-assumptions-new/SKILL.md.

• identify-assumptions-existing: Maps assumptions across 4 risk categories for enhancements to existing products. Source: pm-product-discovery/skills/identify-assumptions-existing/SKILL.md.

• prioritize-assumptions: Ranks assumptions on an Impact × Risk matrix and suggests targeted experiments. Source: pm-product-discovery/skills/prioritize-assumptions/SKILL.md.

Customer Research and Synthesis

Two skills structure customer interactions:

• interview-script: Builds structured JTBD (Jobs-to-be-Done) interview scripts including warm-up, core probing questions, and wrap-up sections. Source: pm-product-discovery/skills/interview-script/SKILL.md.

• summarize-interview: Converts raw interview transcripts into structured templates capturing JTBD insights, satisfaction signals, and action items. Source: pm-product-discovery/skills/summarize-interview/SKILL.md.

Prioritization and Strategic Planning

Four skills enable data-driven decision making:

• analyze-feature-requests: Categorizes, themes, and ranks feature requests by impact, effort, risk, and strategic alignment. Source: pm-product-discovery/skills/analyze-feature-requests/SKILL.md.

• prioritize-features: Ranks backlog items by impact, effort, risk, and alignment, delivering top-5 recommendations. Source: pm-product-discovery/skills/prioritize-features/SKILL.md.

• opportunity-solution-tree: Maps desired outcomes to opportunities, solutions, and experiments (OST framework). Source: pm-product-discovery/skills/opportunity-solution-tree/SKILL.md.

• metrics-dashboard: Defines product metrics dashboards including key metrics, data sources, visualizations, and alert thresholds. Source: pm-product-discovery/skills/metrics-dashboard/SKILL.md.

Invoking pm-product-discovery Skills via CLI

Each skill is accessible through the repository's command façade using the /pm-product-discovery:<command> syntax. The commands process arguments and output markdown reports ready for stakeholder review.

Run a complete discovery workflow for a new product:

pm-product-discovery:discover \
  --product "Smart Home Hub" \
  --stage new

Prioritize a feature backlog against a specific objective:

pm-product-discovery:prioritize-features \
  --input features.csv \
  --objective "Increase monthly active users by 20%"

Generate a JTBD interview script:

pm-product-discovery:interview \
  --script \
  --product "AI-Powered Calendar" \
  --jtbd "Schedule meetings quickly"

Synthesize interview transcripts into structured summaries:

pm-product-discovery:interview \
  --summarize \
  --transcript interview.txt

Build an Opportunity-Solution-Tree from problem statements:

pm-product-discovery:opportunity-solution-tree \
  --problems problems.txt \
  --output ost.md

Source Code Organization

The repository structures skills as both knowledge templates and executable commands:

• Skill Definitions: pm-product-discovery/skills/<skill>/SKILL.md contains detailed prompt templates, context variables, and step-by-step instructions for each discovery activity.

• Command Wrappers: pm-product-discovery/commands/<command>.md maps CLI/Chat-Ops commands to underlying skills, providing human-readable documentation for the interface.

• Package Documentation: pm-product-discovery/README.md offers a quick-reference table of all skills and usage guidelines.

• Repository Index: README.md at the repository root describes the complete pm-skills suite and links to each product area.

Summary

• The pm-product-discovery module contains 13 self-contained skills covering the full discovery lifecycle.
• Skills are implemented as markdown files in pm-product-discovery/skills/<skill>/SKILL.md.
• CLI commands follow the pattern pm-product-discovery:<command> and output stakeholder-ready markdown reports.
• The framework supports both new product development and existing product enhancement workflows.
• Each skill targets specific PM activities: ideation, assumption mapping, experimentation, interviewing, prioritization, and metrics definition.

Frequently Asked Questions

What is the difference between the "new" and "existing" variants of pm-product-discovery skills?

The "new" variants (e.g., brainstorm-ideas-new, identify-assumptions-new) address 8 risk categories including Go-to-Market and Team viability, designed for zero-to-one product development. The "existing" variants focus on 4 core categories (Value, Usability, Viability, Feasibility) for feature enhancements to launched products.

How do pm-product-discovery skills integrate with my existing workflow?

Each skill accepts structured inputs (CSV files, text transcripts) and outputs markdown reports, allowing seamless integration with Git-based documentation, PR workflows, or Chat-Ops platforms. The CLI façade enables programmatic invocation from CI/CD pipelines or PM automation tools.

Where are the skill prompts and templates defined?

The actual prompt logic resides in pm-product-discovery/skills/<skill-name>/SKILL.md files. These markdown files contain the detailed instructions, context requirements, and step sequences that the CLI commands execute when processing your inputs.

Can I run a complete discovery cycle using only these skills?

Yes. The pm-product-discovery:discover command orchestrates a full workflow from ideation through assumption mapping to experiment design. Individual skills can also be invoked independently for targeted activities like interview synthesis or opportunity mapping.

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