PM-Skills README Key Takeaways: AI Operating System for Product Managers

The PM-Skills Marketplace provides 68 reusable product management skills and 42 chained workflows across 9 domain-specific plugins, turning generic LLM output into structured product decision artifacts for Claude Code, Codex, and other AI assistants.

The phuryn/pm-skills repository is an open-source "AI operating system" designed specifically for product-focused AI assistants. According to the main README.md, this marketplace equips tools like Claude Code, Claude Cowork, Codex, Gemini CLI, and OpenCode with a structured catalog of skills, commands, and plugins that transform conversational AI into a systematic product management partner.

Core Architecture: Skills vs Commands vs Plugins

The repository organizes its capabilities into three distinct layers that work together to provide comprehensive product management support.

Skills

Skills are atomic knowledge units stored in individual SKILL.md files. Each skill encapsulates a specific framework, worksheet, or template used by product managers. Examples include brainstorm-ideas-new for ideation and product-strategy for strategic planning. These files follow a universal markdown format that works with any AI assistant capable of reading markdown.

Commands

Commands are slash-triggered workflows that chain one or more skills together. While skills represent individual capabilities, commands orchestrate complete workflows. For instance, /discover runs a full discovery workflow (brainstorm → assumption mapping → prioritize → experiment design), and /write-prd produces an 8-section PRD ready for engineering hand-off.

Plugins

Plugins group related skills and commands into domain-specific packages. The repository contains 9 plugins that can be installed individually or collectively:

1. pm-product-discovery – 13 skills and 5 commands covering ideation, assumption mapping, and experiment design
2. pm-product-strategy – 12 skills and 5 commands for vision, business model, and pricing
3. pm-execution – 16 skills and 11 commands for PRDs, OKRs, roadmaps, and retrospectives
4. pm-market-research – 7 skills and 3 commands for personas, market sizing, and competitor analysis
5. pm-data-analytics – 3 skills and 3 commands for SQL generation, cohort analysis, and A/B testing
6. pm-go-to-market – 6 skills and 3 commands for GTM strategy, ICP definition, and battlecards
7. pm-marketing-growth – 5 skills and 2 commands for marketing ideas, positioning, and North Star metrics
8. pm-toolkit – 4 skills and 5 commands for resume review, legal docs, and proofreading
9. pm-ai-shipping – 2 skills and 5 commands for documentation and static security/performance audits of AI-built code

Installation Methods

The repository supports multiple installation paths depending on which AI assistant you use.

Claude Cowork

Add the marketplace via the plugin picker interface in Claude Cowork. All 9 plugins install automatically, though you can configure individual plugins afterward.

Claude Code

Use the CLI to add the marketplace and install specific plugins:

claude plugin marketplace add phuryn/pm-skills
claude plugin install pm-product-discovery@pm-skills
claude plugin install pm-product-strategy@pm-skills

Codex CLI

The syntax mirrors Claude Code for Codex users:

codex plugin marketplace add phuryn/pm-skills
codex plugin install <plugin>@pm-skills

Practical Usage Examples

Once installed, you can invoke workflows using natural language or slash commands. Below are concrete examples from the CLAUDE.md and plugin documentation.

Run a complete discovery workflow:

/discover AI-powered meeting summarizer for remote teams

Generate a comprehensive strategy canvas:

/strategy B2B project-management tool for agencies

Create a launch-ready PRD:

/write-prd Smart notification system that reduces alert fatigue

Develop a go-to-market plan:

/plan-launch AI code-review tool targeting mid-size engineering teams

Audit a product management resume:

/review-resume [attach my_resume.pdf]

For Codex CLI users, the same capabilities work through natural language prompts after installation:

# After adding the marketplace, simply ask:

# "Run product discovery on my new AI note-taking app: brainstorm ideas, map assumptions, prioritize risky ones, then design experiments."

Cross-Assistant Compatibility

While slash commands are Claude-specific, the underlying skills follow a universal SKILL.md format that functions with any AI assistant capable of reading markdown. This means teams using Gemini CLI, OpenCode, or other assistants can still leverage the 68 individual skills even if the chained workflows (commands) require manual orchestration.

Extensibility and Contribution

The marketplace is designed as a living resource. New skills or plugins can be added via pull request following the guidelines in CONTRIBUTING.md. Each plugin maintains its own documentation in dedicated directories like pm-product-discovery/README.md, pm-execution/README.md, and pm-ai-shipping/README.md, making it easy to understand the specific capabilities and contribution paths for each domain.

Summary

• PM-Skills Marketplace contains 68 atomic skills and 42 chained workflows across 9 domain-specific plugins
• Three-tier architecture: Skills (atomic knowledge), Commands (slash-triggered workflows), and Plugins (domain-specific packages)
• Universal compatibility: Skills work with any markdown-capable AI assistant; commands are Claude/Codex-specific
• Installation flexibility: Supports Claude Cowork (GUI), Claude Code (CLI), and Codex CLI with modular plugin installation
• Comprehensive coverage: From discovery and strategy to execution, analytics, and AI-specific shipping audits
• Open source: Extensible via pull requests with contribution guidelines in CONTRIBUTING.md

Frequently Asked Questions

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

A skill is an atomic knowledge unit—essentially a single framework, template, or worksheet stored in a SKILL.md file. A command is a slash-triggered workflow (like /discover or /write-prd) that chains multiple skills together to produce a complete artifact. While skills provide the raw knowledge, commands orchestrate the process.

Can I use pm-skills with AI assistants other than Claude?

Yes. The individual skills follow a universal markdown format that works with any AI assistant capable of reading markdown files, including Gemini CLI and OpenCode. However, the slash commands that chain skills together are specific to Claude Code, Claude Cowork, and Codex CLI. Users of other assistants can manually prompt the skills in sequence.

How do I install only specific plugins rather than all nine?

While the marketplace can install all 9 plugins automatically, you can select individual ones using the CLI syntax claude plugin install <plugin-name>@pm-skills (or the Codex equivalent). For example, to install only the execution and strategy plugins, run claude plugin install pm-execution@pm-skills and claude plugin install pm-product-strategy@pm-skills.

Where are the skill definitions and documentation stored?

Each plugin maintains its own documentation in dedicated directories at the repository root. Key files include pm-product-discovery/README.md for discovery skills, pm-execution/README.md for execution workflows, and pm-ai-shipping/README.md for AI-specific shipping audits. The universal skill format is documented in CLAUDE.md, and contribution guidelines reside in CONTRIBUTING.md.

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