Is pm-skills a Learning Resource or a Tool? Understanding the Dual-Purpose Repository

pm-skills functions as both a library of reusable product-management frameworks for human learning and a plugin marketplace that installs into AI assistants for automated execution.

The phuryn/pm-skills repository occupies a unique position in the product management ecosystem. It packages proven PM methodologies into markdown-based "skills" that can be read directly by humans or executed by AI agents like Claude, Gemini, and Codex. This hybrid architecture blurs the line between static documentation and interactive tooling, serving as "The AI Operating System for Better Product Decisions" according to the repository README.

How pm-skills Functions as a Learning Resource

As a learning resource, pm-skills provides 9 plugins containing markdown-encoded skill files that document classic PM frameworks. These files are human-readable guides stored in plain text that explain methodologies step-by-step without requiring any software installation.

For example, the file pm-product-discovery/skills/brainstorm-ideas-new/SKILL.md contains a complete ideation framework that can be opened in any browser or text editor for study. Similarly, pm-product-strategy/skills/pricing-strategy/SKILL.md offers detailed guidance on pricing strategies, and pm-execution/skills/user-stories/SKILL.md teaches user story creation techniques. Because these skills are written in standard markdown, they function as portable reference materials that product managers can browse offline or commit to their own knowledge bases.

How pm-skills Functions as a Tool

As a tool, the same markdown files become executable plugins for AI assistants. The repository ships command definitions that chain multiple skills into end-to-end workflows, enabling automation of complex product management processes.

The pm-product-discovery/commands/discover.md file defines the /discover slash command, which automatically invokes underlying skills to run discovery workflows. Similarly, pm-execution/commands/write-prd.md implements the /write-prd command for generating product requirements documents using the create-prd skill. According to the phuryn/pm-skills README, "Skills are loaded automatically when relevant to the conversation – no explicit invocation needed", allowing AI assistants to surface guidance contextually without manual prompting.

Installation and Usage Examples

The following examples demonstrate both the learning resource and tool aspects of pm-skills.

Installing as a Tool

# Add the entire marketplace to Claude Code

claude plugin marketplace add phuryn/pm-skills

# Install only the product-discovery plugin

claude plugin install pm-product-discovery@pm-skills

# Execute a discovery workflow (AI invokes skills automatically)

/discover AI-powered meeting-summarizer for remote teams

Using as a Learning Resource

# Read a skill file directly for self-study

cat pm-product-strategy/skills/pricing-strategy/SKILL.md

# Copy skills for use in other AI environments like Gemini

mkdir -p ~/.gemini/skills/
cp -r pm-marketing-growth/skills/* ~/.gemini/skills/

The Architecture Behind the Dual Purpose

The repository's design relies on machine-parsable markdown that remains human-readable. Each skill file contains structured guidance that AI agents can interpret as instructions while humans read as documentation. This architecture enables the repository to support multiple AI platforms—including Claude-Code, Claude-Cowork, Codex, Gemini, and OpenCode—through the same source files.

The plugin marketplace manifest coordinates how these files are distributed, allowing users to install individual plugins (such as pm-go-to-market or pm-execution) or the entire suite. When installed, the markdown skills become native capabilities of the host AI assistant, while the original files remain available for direct inspection and learning.

Summary

• pm-skills serves dual purposes as both educational content and executable software for AI automation
• Nine plugins provide frameworks for discovery, execution, strategy, and go-to-market activities
• SKILL.md files function as human-readable documentation and AI-executable instructions simultaneously
• Slash commands like /discover and /write-prd automate multi-step workflows by chaining skills
• The repository integrates with Claude, Gemini, Codex, and OpenCode through standard plugin installation
• Files such as pm-product-discovery/skills/brainstorm-ideas-new/SKILL.md demonstrate the seamless boundary between learning material and tool functionality

Frequently Asked Questions

Can I use pm-skills without an AI assistant?

Yes. While designed for AI integration, the SKILL.md files are plain markdown documents that can be opened and read directly in any text editor or browser. You can browse pm-product-discovery/skills/brainstorm-ideas-new/SKILL.md or any other skill file to learn the frameworks manually without installing any plugins or using the marketplace features.

Which AI platforms support pm-skills plugins?

The repository supports Claude-Code, Claude-Cowork, Codex, Gemini, and OpenCode. Each platform can load the markdown skills either through the marketplace installation command (claude plugin marketplace add phuryn/pm-skills) or by copying skill files into the platform's native skills directory, such as ~/.gemini/skills/ for Gemini CLI.

What is the difference between a skill and a command in pm-skills?

A skill is a single framework or methodology stored in a SKILL.md file, such as the pricing strategy guide in pm-product-strategy/skills/pricing-strategy/SKILL.md. A command chains multiple skills into a workflow—for example, the /discover command defined in pm-product-discovery/commands/discover.md coordinates several discovery skills to run a complete product discovery process end-to-end.

How many plugins are available in the pm-skills marketplace?

The repository ships 9 plugins covering domains such as product discovery (pm-product-discovery), execution (pm-execution), go-to-market (pm-go-to-market), and product strategy (pm-product-strategy). Each plugin contains multiple skills and commands that can be installed individually or as part of the complete marketplace.

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