# Is pm-skills a Learning Resource or a Tool? Understanding the Dual-Purpose Repository > Discover if pm-skills is a learning resource or a tool. Explore its dual purpose as a reusable framework library and an AI assistant plugin for automated product management. - Repository: [Pawel Huryn/pm-skills](https://github.com/phuryn/pm-skills) - Tags: overview - Published: 2026-07-08 --- **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`](https://github.com/phuryn/pm-skills/blob/main/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`](https://github.com/phuryn/pm-skills/blob/main/pm-product-strategy/skills/pricing-strategy/SKILL.md) offers detailed guidance on pricing strategies, and [`pm-execution/skills/user-stories/SKILL.md`](https://github.com/phuryn/pm-skills/blob/main/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`](https://github.com/phuryn/pm-skills/blob/main/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`](https://github.com/phuryn/pm-skills/blob/main/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 ```bash # 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 ```bash # 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`](https://github.com/phuryn/pm-skills/blob/main/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`](https://github.com/phuryn/pm-skills/blob/main/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`](https://github.com/phuryn/pm-skills/blob/main/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`](https://github.com/phuryn/pm-skills/blob/main/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.