Pm Skills Mcp

PM-Skills MCP

Open-source MCP server exposing 40 best-practice product management skills plus workflows and lifecycle tools, instantly accessible to any AI via Model Context Protocol.

Report a Bug · Request a Feature · Ask a Question

> Want to customize skills or use slash commands? This server is powered by pm-skills, the open-source skill library you can fork and modify. Browse the full catalog, interactive showcase, and setup guides at product-on-purpose.github.io/pm-skills.

> [!IMPORTANT] > Maintenance Mode (effective 2026-05-04) > > Active development on pm-skills-mcp is paused pending demonstrated demand. The latest release is v2.9.3 (security patch shipped 2026-05-05; embedded catalog frozen at the v2.9.2 build) which remains fully functional and exposes a catalog of 40 PM skills, 11 workflows, and 8 utility tools (59 tools total) via the Model Context Protocol. Security patches and critical bug fixes will continue to be addressed; new skill parity with the upstream pm-skills library is on hold, so the catalog will continue to drift from pm-skills as new skills are added there. > > For new users: the file-based install path documented in the main pm-skills repository is under active maintenance and is the recommended path going forward. > > To register interest in resumed development: open a GitHub Discussion.

---

About • Getting Started • Usage • Status • Contributing • Community

Table of Contents

• [The Big Idea](#the-big-idea)
• [Why MCP?](#why-mcp)
• [The Transformation](#the-transformation)
• [Key Features](#key-features)
• [Built with...](#built-with)
• [Works for...](#works-for)
• [Comparison: pm-skills-mcp (this repo) vs. pm-skills](#comparison-pm-skills-mcp-this-repo-vs-pm-skills)
• [Getting Started](#getting-started)
• [NPM Global Install](#npm-global-install)
• [From Source](#from-source)
• [Quick Start by Platform](#quick-start-by-platform)
• [Configuration](#configuration)
• [Usage](#usage)
• [How It Works](#how-it-works)
• [Tools](#tools)
• [The Skills](#the-skills)
• [🔗 Workflows - Multi-skill workflows](#-workflows---multi-skill-workflows)
• [🛠️ Utility Tools](#️-utility-tools)
• [MCP Resources](#mcp-resources)
• [Prompts](#prompts)
• [Guides](#guides)
• [Project Status](#project-status)
• [Releases](#releases)
• [Project Structure](#project-structure)
• [Changelog](#changelog)
• [Roadmap](#roadmap)
• [Development](#development)
• [Testing](#testing)
• [Code Quality](#code-quality)
• [CI/CD](#cicd)
• [Security](#security)
• [Contributing](#contributing)
• [How to Contribute](#how-to-contribute)
• [Reporting Bugs](#reporting-bugs)
• [About](#about)
• [Author](#author)
• [License](#license)
• [Security](#security-1)
• [Acknowledgments](#acknowledgments)
• [Community](#community)

---

Quick Start (NPM Global Install)

npm install -g pm-skills-mcp

---

The Big Idea

PM-Skills MCP is an MCP server that transforms PM-Skills, a collection of 40 best-practice product management skills, into programmatically accessible tools, resources, and prompts for any AI assistant that speaks the Model Context Protocol.

PM-Skills MCP is built on pm-skills, an open-source collection of 40 PM skills organized by the Triple Diamond framework. While pm-skills offers file-based access with slash commands and AGENTS.md discovery, pm-skills-mcp wraps those same skills in an MCP server for programmatic access. The pm-skills library now includes lifecycle tools (Create, Validate, Iterate) and a documentation site with an interactive showcase.

Not sure which to use? See the [Comparison](#comparison-pm-skills-mcp-this-repo-vs-pm-skills) section below, or the MCP Setup Guide on the docs site.

One connection. 40 skills. Any MCP client.

Why MCP?

The Model Context Protocol is an open standard that lets AI assistants connect to external tools and data sources. Instead of manually copying skill files or uploading ZIP archives, PM-Skills MCP gives your AI direct, programmatic access to the entire PM skill library.

The Transformation

| File-Based Approach | MCP-Powered Approach | | ---------------------------------- | --------------------------------- | | Clone repo, navigate to skills | npx pm-skills-mcp - done | | Copy/paste skill content into chat | AI invokes tools directly | | Manual template injection | Automatic template retrieval | | Platform-specific slash commands | Universal across all MCP clients | | Static markdown files | Dynamic, parameterized tools | | Works in one IDE/client | Works everywhere MCP is supported |

Key Features

• 59 MCP Tools - 40 PM skills + 11 workflows + 8 utility tools
• MCP Resources - Skill instructions, templates, and examples via URI, with optional persona resources when enabled
• 3 MCP Prompts - Guided conversation starters for common workflows
• 11 Workflows - Pre-built multi-skill workflows for common scenarios
• 81 Automated Tests - Comprehensive test coverage with Vitest
• Zero Configuration - Works out of the box with embedded skills
• Universal Compatibility - Claude Desktop, Cursor, Continue, and any MCP client
• Customizable - Override with your own skill modifications
• Lightweight - Minimal dependencies, fast startup
• Security Scanning - CodeQL analysis on every push

Built with...

• Model Context Protocol - Open standard for AI tool connectivity
• PM-Skills - The 40 PM skills this server exposes (docs site)
• TypeScript - Type-safe implementation
• Vitest - Fast, modern testing framework

Works for...

PM-Skills MCP works with any client that supports the Model Context Protocol. Here's a quick overview:

Platform Compatibility

| Platform | Status | Integration Type | Notes | | ------------------- | ------------ | --------------------- | ---------------------------------- | | Claude Code | ✅ Native | MCP Server | Full tool access via CLI | | Claude Desktop | ✅ Native | MCP Server | Recommended for best experience | | Claude.ai | ✅ Native | MCP Server (Projects) | Via MCP integration in Projects | | Cursor | ✅ Native | MCP Server | AI-powered IDE | | VS Code | ✅ Native | Via Cline/Continue | Multiple MCP-compatible extensions | | Continue | ✅ Native | MCP Server | Open-source coding assistant | | Cline | ✅ Native | MCP Server | VS Code extension | | Windsurf | ✅ Native | MCP Server | AI-native IDE | | GitHub Copilot | 🔶 Indirect | Via MCP-enabled tools | Use with Copilot Chat + MCP | | OpenCode | 🔶 Indirect | Via MCP-compatible config | Use standard stdio MCP server pattern | | ChatGPT / Codex | 🔶 Manual | Copy skill content | No native MCP support | | Any MCP Client | ✅ Universal | Protocol-level | Full compatibility |

See the [Integration Guide](docs/integration-guide.md) for detailed setup instructions for each platform.

Comparison: pm-skills-mcp (this repo) vs. pm-skills

PM-Skills is available in two complementary forms:

| | pm-skills-mcp (this repo) | pm-skills | |---|---|---| | What it is | MCP server wrapping the skill library | Skill library as markdown files | | Access method | npx pm-skills-mcp | Git clone, ZIP upload | | Setup time | 30 seconds | 2-5 minutes | | Skill invocation | MCP tool calls | Slash commands (Claude Code) | | Auto-discovery | MCP protocol (Claude Desktop, Cursor) | AGENTS.md (Copilot, Cursor, Windsurf) | | Template access | URI-based resources | Navigate file system | | Workflows | Tool-based execution | Manual orchestration | | Customization | Set PM_SKILLS_PATH to custom folder | Edit files directly | | Updates | npm update pm-skills-mcp | git pull |

Use pm-skills-mcp (this repo) when:

• You want instant setup with npx pm-skills-mcp
• You're using Claude Desktop, Cursor, or any MCP client
• You want programmatic tool access without managing files
• You prefer consistent interfaces across different AI clients

Use pm-skills (file-based) when:

• You prefer slash commands in Claude Code (/prd, /hypothesis)
• You want to browse, read, and customize skill files directly
• You're using GitHub Copilot, OpenCode, or Windsurf without reliable MCP support
• You want to fork and heavily customize skills for your team

Using Both Together: Fork pm-skills to customize skills, then point pm-skills-mcp to your fork:

{
  "mcpServers": {
    "pm-skills": {
      "command": "npx",
      "args": ["pm-skills-mcp"],
      "env": {
        "PM_SKILLS_PATH": "/path/to/my/forked/pm-skills/skills"
      }
    }
  }
}

(back to top)

---

Getting Started

This section covers quick installation. For a comprehensive walkthrough including core concepts, your first tool invocation, workflows, and troubleshooting, see the [Getting Started Guide](docs/getting-started.md).

NPM Global Install

npm install -g pm-skills-mcp

Run directly:

pm-skills-mcp

From Source

git clone https://github.com/product-on-purpose/pm-skills-mcp.git
cd pm-skills-mcp
npm install
npm run build
npm start

Quick Start by Platform

Claude Desktop

The recommended client for pm-skills-mcp. Add to your Claude Desktop configuration:

Config file location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Configuration:

{
  "mcpServers": {
    "pm-skills": {
      "command": "npx",
      "args": ["pm-skills-mcp"]
    }
  }
}

Restart Claude Desktop. You now have access to all 40 PM skills as tools (catalog frozen at the v2.9.2 build; see Maintenance Mode notice above).

Claude Code (CLI)

Add to .claude/settings.json in your project or ~/.claude/settings.json globally:

{
  "mcpServers": {
    "pm-skills": {
      "command": "npx",
      "args": ["pm-skills-mcp"]
    }
  }
}

Cursor

Navigate to Settings → Features → MCP Servers, then add:

{
  "pm-skills": {
    "command": "npx",
    "args": ["pm-skills-mcp"]
  }
}

Restart Cursor. The 40 PM skill tools will be available in AI chat (catalog frozen at the v2.9.2 build; see Maintenance Mode notice above).

GitHub Copilot (MCP-enabled)

Configure your Copilot MCP extension/integration with the same stdio server pattern:

{
  "mcpServers": {
    "pm-skills": {
      "command": "npx",
      "args": ["pm-skills-mcp"]
    }
  }
}

If your Copilot surface does not currently expose MCP server configuration, use file-based pm-skills with AGENTS.md as the fallback path.

OpenCode (MCP-enabled)

Use OpenCode's MCP server configuration with the standard npx pm-skills-mcp pattern:

{
  "mcpServers": {
    "pm-skills": {
      "command": "npx",
      "args": ["pm-skills-mcp"]
    }
  }
}

If MCP is unavailable in your current OpenCode setup, use file-based pm-skills and AGENTS.md.

VS Code (Cline / Continue)

With Cline:

1. Install Cline from VS Code Marketplace
2. Open Cline settings and configure MCP server:

``json { "pm-skills": { "command": "npx", "args": ["pm-skills-mcp"] } } ``

With Continue:

1. Install Continue from VS Code Marketplace
2. Configure MCP in Continue settings

Other MCP Clients

Any MCP-compatible client can use pm-skills-mcp. The general pattern:

1. Configure an MCP server with command npx and args ["pm-skills-mcp"]
2. Restart the client
3. All 40 PM skills become available as tools (catalog frozen at the v2.9.2 build; see Maintenance Mode notice above)

See the [Integration Guide](docs/integration-guide.md) for detailed instructions for all platforms.

Configuration

Environment Variables

| Variable | Default | Description | | -------------------- | ---------- | ------------------------------- | | PM_SKILLS_PATH | (embedded) | Path to custom skills directory | | PM_PERSONAS_PATH | (auto) | Path to persona library resources | | PM_SKILLS_FORMAT | full | Default output format | | PM_SKILLS_INCLUDE_EXAMPLES | false | Include examples by default |

Custom Skills Path

Override embedded skills with your customized versions:

{
  "mcpServers": {
    "pm-skills": {
      "command": "npx",
      "args": ["pm-skills-mcp"],
      "env": {
        "PM_SKILLS_PATH": "/path/to/my/custom/skills"
      }
    }
  }
}

Using Custom Skills from a pm-skills Fork

If you've forked pm-skills to customize skills:

1. Clone your fork locally
2. Make changes to skills in skills/{phase-skill}/ (e.g., skills/deliver-prd/)
3. Point pm-skills-mcp to your fork:

{
  "mcpServers": {
    "pm-skills": {
      "command": "npx",
      "args": ["pm-skills-mcp"],
      "env": {
        "PM_SKILLS_PATH": "/path/to/my-pm-skills-fork/skills"
      }
    }
  }
}

See the pm-skills authoring guide for skill modification guidelines.

(back to top)

---

Usage

How It Works

┌─────────────────────────────────────────────────────────────┐
│                    Your AI Assistant                        │
│              (Claude, Cursor, Continue, etc.)               │
└──────────────────────────┬──────────────────────────────────┘
                           │ MCP Protocol
                           ▼
┌─────────────────────────────────────────────────────────────┐
│                    pm-skills-mcp Server                     │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│   ┌─────────────┐   ┌─────────────┐   ┌─────────────┐       │
│   │   59 Tools  │   │  Resources  │   │  3 Prompts  │       │
│   │             │   │             │   │             │       │
│   │ • 40 skills │   │ • templates │   │ • kickoff   │       │
│   │ • 11 flo

…

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [product-on-purpose](https://github.com/product-on-purpose)
- **Source:** [product-on-purpose/pm-skills-mcp](https://github.com/product-on-purpose/pm-skills-mcp)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.