# PM-Skills README Key Takeaways: AI Operating System for Product Managers > Discover key takeaways from the PM-Skills README! Learn how this AI operating system for product managers transforms LLM output into structured product decision artifacts using 68 skills and 42 workflows. - Repository: [Pawel Huryn/pm-skills](https://github.com/phuryn/pm-skills) - Tags: key-takeaways - Published: 2026-07-08 --- **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](https://github.com/phuryn/pm-skills/blob/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`](https://github.com/phuryn/pm-skills/blob/main/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: ```bash 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: ```bash codex plugin marketplace add phuryn/pm-skills codex plugin install @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`](https://github.com/phuryn/pm-skills/blob/main/CLAUDE.md) and plugin documentation. Run a complete discovery workflow: ```text /discover AI-powered meeting summarizer for remote teams ``` Generate a comprehensive strategy canvas: ```text /strategy B2B project-management tool for agencies ``` Create a launch-ready PRD: ```text /write-prd Smart notification system that reduces alert fatigue ``` Develop a go-to-market plan: ```text /plan-launch AI code-review tool targeting mid-size engineering teams ``` Audit a product management resume: ```text /review-resume [attach my_resume.pdf] ``` For **Codex CLI** users, the same capabilities work through natural language prompts after installation: ```bash # 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`](https://github.com/phuryn/pm-skills/blob/main/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`](https://github.com/phuryn/pm-skills/blob/main/CONTRIBUTING.md). Each plugin maintains its own documentation in dedicated directories like [`pm-product-discovery/README.md`](https://github.com/phuryn/pm-skills/blob/main/pm-product-discovery/README.md), [`pm-execution/README.md`](https://github.com/phuryn/pm-skills/blob/main/pm-execution/README.md), and [`pm-ai-shipping/README.md`](https://github.com/phuryn/pm-skills/blob/main/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`](https://github.com/phuryn/pm-skills/blob/main/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`](https://github.com/phuryn/pm-skills/blob/main/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 @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`](https://github.com/phuryn/pm-skills/blob/main/pm-product-discovery/README.md) for discovery skills, [`pm-execution/README.md`](https://github.com/phuryn/pm-skills/blob/main/pm-execution/README.md) for execution workflows, and [`pm-ai-shipping/README.md`](https://github.com/phuryn/pm-skills/blob/main/pm-ai-shipping/README.md) for AI-specific shipping audits. The universal skill format is documented in [`CLAUDE.md`](https://github.com/phuryn/pm-skills/blob/main/CLAUDE.md), and contribution guidelines reside in [`CONTRIBUTING.md`](https://github.com/phuryn/pm-skills/blob/main/CONTRIBUTING.md).