Pm Skills

A curated collection of essential product management skills and templates for effective project execution.

<h1 align="center"> <a href="https://github.com/product-on-purpose/pm-skills">PM-Skills</a> </h1> <h4 align=”center”>A curated collection of 38 best-practice, plug-and-play product management “agent skills” (25 phase skills + 7 foundation skills + 6 utility skills) plus templates and workflows for consistent, professional PM outputs.</h4> <a href="https://github.com/product-on-purpose/pm-skills/issues/new?labels=bug">Report a Bug</a> · <a href="https://github.com/product-on-purpose/pm-skills/issues/new?labels=enhancement">Request a Feature</a> · <a href="https://github.com/product-on-purpose/pm-skills/discussions">Ask a Question</a> <img src="https://img.shields.io/badge/Status-Active-success?style=flat-square" alt="Project Status: Active"> <a href="https://github.com/product-on-purpose/pm-skills/blob/main/LICENSE"> <img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg?style=flat-square" alt="License"> </a> <a href="https://github.com/product-on-purpose/pm-skills/releases"> <img src="https://img.shields.io/badge/version-2.11.0-blue.svg?style=flat-square" alt="Version"> </a> <a href="#the-skills"> <img src="https://img.shields.io/badge/skills-38-brightgreen.svg?style=flat-square" alt="Skills"> </a> <a href="https://agentskills.io/specification"> <img src="https://img.shields.io/badge/spec-agentskills.io-orange.svg?style=flat-square" alt="Agent Skills Spec"> </a> <a href="CONTRIBUTING.md"> <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square" alt="PRs Welcome"> </a> <a href="https://github.com/product-on-purpose/pm-skills/stargazers"> <img src="https://img.shields.io/github/stars/product-on-purpose/pm-skills?style=flat-square" alt="Stars"> </a> <a href="https://github.com/product-on-purpose/pm-skills/network/members"> <img src="https://img.shields.io/github/forks/product-on-purpose/pm-skills?style=flat-square" alt="Forks"> </a> <a href="https://github.com/product-on-purpose/pm-skills/issues"> <img src="https://img.shields.io/github/issues/product-on-purpose/pm-skills?style=flat-square" alt="Issues"> </a> <a href="https://github.com/product-on-purpose/pm-skills/graphs/contributors"> <img src="https://img.shields.io/github/contributors/product-on-purpose/pm-skills?style=flat-square" alt="Contributors"> </a> <img src="https://img.shields.io/github/last-commit/product-on-purpose/pm-skills?style=flat-square" alt="Last Commit">  <a href="https://github.com/product-on-purpose/pm-skills-mcp"> <img src="https://img.shields.io/badge/MCP_Server-available-purple.svg?style=flat-square" alt="MCP Server Available"> </a>

🔥MCP Server Available! If you are using VS Code, Claude Desktop, Claude Code (CLI), Github Copilot, Cursor, etc... check out pm-skills-mcp for instant MCP access to the shipped skill library and workflows - no file management required.

<a href="#the-big-idea">About</a> • <a href="#getting-started">Getting Started</a> • <a href="#the-skills">Skills</a> • <a href="#workflows">Workflows</a> • <a href="#project-status">Status</a> • <a href="#contributing">Contributing</a> • <a href="#community">Community</a> <details> <summary>Table of Contents</summary>

The Big Idea
Getting Started
Usage
Project Status
Contributing
- How to Contribute
- Reporting Bugs
FAQ
About
- Author
- License
Community

</details>

Quick Start (Clone and go!)

git clone https://github.com/product-on-purpose/pm-skills.git && cd pm-skills

What's New (Recent Releases)

<details open> <summary>v2.11.0 - Meeting Skills Family + Lean Canvas: first cross-cutting skill-family contract</summary>

New foundation skill: foundation-lean-canvas (/lean-canvas) — one-page business thesis across nine interlocking blocks (problem, customer, UVP, solution, channels, revenue, cost, metrics, unfair advantage). Two modes: content (structured markdown) and visual (self-contained HTML with A3 landscape print styling).
New foundation family — the 5-skill Meeting Skills Family, governed by a canonical contract (docs/reference/skill-families/meeting-skills-contract.md) with enforcing CI:
- foundation-meeting-agenda (/meeting-agenda) — attendee-facing structural agenda with time-boxed topics, type tags, owners, prep; 10 meeting-type variants
- foundation-meeting-brief (/meeting-brief) — private strategic prep with stakeholder reads, ranked outcomes, anticipated Q&A
- foundation-meeting-recap (/meeting-recap) — topic-segmented post-meeting summary with decisions bold-flagged and actions inline; auto-discovers sibling agenda
- foundation-meeting-synthesize (/meeting-synthesize) — cross-meeting archaeology surfacing patterns, trajectories, contradictions
- foundation-stakeholder-update (/stakeholder-update) — async outward comms with 5 channel × 5 audience variants
New pattern: docs/reference/skill-families/ — canonical home for cross-cutting skill-family contracts. Meeting Skills Contract is the first entry; future families (research, delivery) can add entries.
New CI: validate-meeting-skills-family.sh/.ps1 — enforcing validation of contract conformance, filename convention, and shareable-boundary structure.
New end-user guide: Using the Meeting Skills Family with mermaid diagrams covering skill chain, go-mode flow, and family lifecycle.
Sample library: 94 → 120 outputs; 15 thread-aligned samples (3 per meeting skill × storevine/brainshelf/workbench) added.
Process improvement: Pre-release checklist now requires a Phase 0 Adversarial Review Loop (Codex adversarial review → resolution → re-run until findings stabilize below IMPORTANT). Codified from v2.11.0 experience where Round 2 of review surfaced 6 additional IMPORTANT issues in the Round 1 resolution pass itself.
Repo now ships 38 skills (25 phase + 7 foundation + 6 utility), 45 command docs, and 9 workflows.
Release note: docs/releases/Release_v2.11.0.md.

</details> <details> <summary>v2.10.x - Utility skill expansion: mermaid diagrams, slideshows, self-updating</summary>

New skill: utility-mermaid-diagrams (/mermaid-diagrams) — 15 diagram types with dual-lens navigation (type catalog + PM use-case guide), dedicated syntax validity reference, and worked examples.
New skill: utility-slideshow-creator (/slideshow-creator) — generates professional presentations from JSON deck specs; 18 slide types with dark/light variants and Google Slides compatibility.
New skill: utility-update-pm-skills (/update-pm-skills) — checks for newer releases, previews changes with --report-only, and applies updates with confirmation. Includes backup, value-delta report, and post-update smoke test.
Sample library: 84 → 91 outputs, now covering all 32 skills.
Tooling: generate-skill-pages.py now computes skill/command/workflow counts dynamically, eliminating stale-count drift.
Repo now ships 32 skills, 39 command docs, and 9 workflows.
v2.10.1 patch: backlog spec drafts for 10 upcoming skills, generated docs/skills/ pages, F-25 scope moved to agent-config-toolkit.
v2.10.2 patch: corrected plugin / marketplace manifest skill counts (29 → 32) to match repo state; extended check-count-consistency CI to scan JSON manifests and closed an off-by-one in its threshold comparison; fixed README "10 workflows" to "9 workflows".

</details> <details> <summary>v2.9.0 - Workflows: rename + expansion (3 → 9)</summary>

BREAKING: Renamed _bundles/ → _workflows/ and docs/bundles/ → docs/workflows/
BREAKING: /kickoff command replaced by /workflow-feature-kickoff
6 new workflows: Customer Discovery, Sprint Planning, Product Strategy, Post-Launch Learning, Stakeholder Alignment, Technical Discovery
7 /workflow-* slash commands (1 renamed + 6 new)
New script: scripts/generate-workflow-pages.py — generates docs site pages from source workflows
URL redirects for old /bundles/* doc site paths via mkdocs-redirects
Terminology guard: scripts/check-stale-bundle-refs.sh/.ps1 prevents regression
Repo now ships 31 skills, 38 command docs, and 9 workflows.
Release note: docs/releases/Release_v2.9.0.md.

</details> <details> <summary>v2.8.0 - PM skill lifecycle: Create, Validate, Iterate</summary>

New skill: utility-pm-skill-validate (/pm-skill-validate) — audits a skill against structural conventions and quality criteria, producing a severity-graded validation report.
New skill: utility-pm-skill-iterate (/pm-skill-iterate) — applies targeted improvements based on feedback or validation reports, with before/after previews and version bump suggestions.
New CI: validate-skill-history and validate-skills-manifest advisory scripts for skill versioning governance.
New guide: docs/pm-skill-lifecycle.md — workflow patterns for the Create → Validate → Iterate lifecycle.
Governance: docs/internal/skill-versioning.md — SemVer rules, HISTORY.md contract, skills-manifest.yaml format.
Repo now ships 29 skills, 30 command docs, and 3 workflows.
Release note: docs/releases/Release_v2.8.0.md.

</details> <details> <summary>v2.7.0 - Utility skills, enhanced CI, and release packaging hygiene</summary>

New skill: deliver-acceptance-criteria — Given/When/Then acceptance criteria for stories and features.
New skill: utility-pm-skill-builder — first utility-classified skill; interactive builder for creating new PM skills with gap analysis, classification, and draft file generation.
Enhanced CI: extended frontmatter linter, AGENTS.md sync validator, MCP impact detection.
Release packaging: docs/internal/** excluded from published ZIPs while staying tracked in-repo.
Documentation: new docs/pm-skill-anatomy.md guide, comprehensive public docs refresh.
Repo now ships 27 skills, 28 command docs, and 3 workflows.
Release note: docs/releases/Release_v2.7.0.md.

</details> <details> <summary>v2.6.x - Claude plugin packaging + sample library recovery</summary>

v2.6.1 — Sample library recovery and packaging inclusion:

Restored and normalized the shipped sample-output corpus under library/skill-output-samples/.
Added sample-library staging to release packagers so ZIP artifacts include sample outputs.
Release note: docs/releases/Release_v2.6.1.md.

v2.6.0 — Claude plugin packaging release:

Added Claude plugin manifest support via .claude-plugin/plugin.json.
Release packaging now includes .claude-plugin/ and enforces plugin-manifest version alignment with the release version.
Release note: docs/releases/Release_v2.6.0.md.

</details>

View previous release details | Full changelog

The Big Idea

Stop prompt-fumbling. Start shipping. Every time you ask an AI to help with product management, you start from zero. Generic responses. Inconsistent formats. Missing critical sections. Hours lost to repetitive prompt crafting.

PM-Skills changes that and gives your AI-tool-of-choice instant access to:

Professional frameworks refined across hundreds of product launches
Production-ready templates that capture institutional PM knowledge
Real-world examples that set the quality bar

You: "Create a PRD for our new search feature"

AI + PM-Skills: Generates a comprehensive PRD with problem statement,
                success metrics, user stories, scope definition, and
                technical considerations-all in professional format.

The Problem

Every time you ask an AI to help with product management, you start from zero. Generic responses. Inconsistent formats. Missing critical sections. Hours spent prompt-engineering the same workflows.

The Solution

PM-Skills gives your AI instant access to field-tested frameworks, templates, and examples for every stage of product development.

Without PM-Skills	With PM-Skills
⚠️ Generic AI responses	✅ Professional PM frameworks
⚠️ Inconsistent formats	✅ Production-ready templates
⚠️ Missing key sections	✅ Comprehensive coverage
⚠️ Starting from scratch	✅ Building on best practices
⚠️ Prompt engineering every time	✅ One command, instant results

Key Features

✅ 32 Production-Ready Skills covering the complete product lifecycle (25 phase skills + 1 foundation skill + 6 utility skills)
✅ Triple Diamond Framework organizing Discover, Define, Develop, Deliver, Measure, and Iterate phases
✅ 9 Workflows for common PM processes (Feature Kickoff, Lean Startup, Triple Diamond, and 6 more)
✅ Slash Commands for Claude Code users-instant access to every skill
✅ Auto-Discovery via AGENTS.md in GitHub Copilot, Cursor, and Windsurf
✅ Agent Skills Spec compliant-works across AI assistants
✅ Best-Practice Templates based on industry best practices
✅ Comprehensive Documentation with examples and references
✅ Apache 2.0 Licensed for commercial and personal use

Skill Lifecycle Tools

PM-Skills includes three utility skills that form a complete Create → Validate → Iterate lifecycle for managing skills themselves:

flowchart LR
    Create["/pm-skill-builder\nCreate"] --> Validate["/pm-skill-validate\nValidate"]
    Validate --> Decision{Findings?}
    Decision -- "PASS" --> Ship["Ship"]
    Decision -- "WARN / FAIL" --> Iterate["/pm-skill-iterate\nIterate"]
    Iterate --> Validate

Tool	Command	What it does
Builder	`/pm-skill-builder`	Creates a new skill from an idea — runs gap analysis against all existing skills, classifies by type and phase, generates draft files to a staging area, and promotes on confirmation
Validator	`/pm-skill-validate`	Audits an existing skill against structural conventions and quality criteria — produces a report with severity-graded findings and actionable recommendations
Iterator	`/pm-skill-iterate`	Applies targeted improvements to a skill based on feedback or a validation report — previews changes, writes on confirmation, suggests a version bump

Why this matters: Skills are living artifacts that evolve. The builder creates them, the validator catches drift and quality gaps, and the iterator applies fixes. Together they keep the library consistent as it grows.

Quick example:

# Create a new skill
/pm-skill-builder "A skill for writing stakeholder update emails"

# Validate it meets conventions
/pm-skill-validate stakeholder-update-email

# Fix any findings
/pm-skill-iterate stakeholder-update-email   # paste the validation report

See PM-Skill Lifecycle for workflow patterns and detailed usage.

Built with...

Agent Skills Specification - Open standard for AI-agent skills
GitHub Flavored Markdown - Universal documentation format
Keep a Changelog - Structured release documentation
Best-README-Template - README inspiration

Founded on...

Triple Diamond Framework - Product development methodology
Teresa Torres' Opportunity Solution Trees - Outcome-driven discovery
Jobs to be Done Framework - Customer motivation framework
Architecture Decision Records - Technical decision documentation
Design Council's Double Diamond - Foundation of our Triple Diamond framework
Michael Nygard - ADR format we adapted

Works for...

PM-Skills follows the Agent Skills Specification and works natively across the AI ecosystem.

Platform Compatibility

Platform	Status	Method	Notes
Claude Code	✅ Native	Slash commands; optional `sync-claude.(sh	ps1)`to populate`.claude/` cache
Claude.ai	✅ Native	ZIP upload	Upload to Projects
Claude Desktop	✅ Native	ZIP upload or MCP	MCP recommended for programmatic access
GitHub Copilot	✅ Native	AGENTS.md discovery	Auto-discovers in repo
Cursor	✅ Native	AGENTS.md or MCP	MCP for programmatic tool access; sync helper optional if using openskills
Windsurf	✅ Native	AGENTS.md discovery	Auto-discovers; sync helper not needed
VS Code	✅ Native	Via extensions	Cline, Continue, or manual
OpenCode	✅ Native	Skill format	Direct skill loading
Any MCP Client	✅ Universal	pm-skills-mcp	Protocol-level access
ChatGPT / Codex	🔶 Manual	Copy skill content	No native support
Other AI Tools	🔶 Manual	Copy skill content	Works with any LLM

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

PM-Skills is available in two complementary forms:

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

Note: pm-skills-mcp v1.x targets the legacy nested layout; use pm-skills-mcp v2.4+ for version-aligned parity with pm-skills v2.4+.

Use pm-skills (this repo) 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 or Windsurf with AGENTS.md discovery
You want to fork and heavily customize skills for your team

Use pm-skills-mcp 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

Both approaches give you access to the same 32 production-ready PM skills (25 phase skills + 1 foundation skill + 6 utility skills).

See the Ecosystem Overview for a detailed comparison.

(<a href="#readme-top">back to top</a>)

Getting Started

Quick start: Clone and go.

git clone https://github.com/product-on-purpose/pm-skills.git && cd pm-skills

Need platform-specific instructions? See Quick Start by Platform below.

Want a detailed walkthrough? Check our Getting Started Guide.

Docs navigation: Quickest: this README’s Quick Start or QUICKSTART.md in the repo/release ZIP. Detailed: docs/getting-started.md (long-form).

Install as Claude Code Plugin

Use this option if your Claude client supports plugin-manifest install flows.

Clone the repo or extract the release ZIP.
During plugin setup, select the manifest at .claude-plugin/plugin.json.
Complete install in your client and reload if prompted.

Example local setup:

git clone https://github.com/product-on-purpose/pm-skills.git
cd pm-skills
# Then point your client to: .claude-plugin/plugin.json

Installation Options

Method	Best For	Command / Action
Git Clone	Claude Code, Copilot, Cursor, Windsurf	`git clone https://github.com/product-on-purpose/pm-skills.git`
ZIP Download	Claude.ai, Claude Desktop	Download Latest Release
MCP Server	Programmatic tool access	`npx pm-skills-mcp` (pm-skills-mcp)

Quick Start by Platform

<details> <summary>Claude Code</summary>

No setup needed! Skills work directly via slash commands in your terminal:

# Clone the repo to get slash commands
git clone https://github.com/product-on-purpose/pm-skills.git
cd pm-skills

# Use any skill with slash commands
/prd "Search feature for e-commerce platform"
/hypothesis "Will one-page checkout increase conversion?"
/user-stories "Recurring tasks feature from PRD"

All 38 skills are available as /skill-name commands. See commands/ for the full list.

Need .claude/skills for openskills or certain discovery flows? After cloning, run:

./scripts/sync-claude.sh   # macOS/Linux
./scripts/sync-claude.ps1  # Windows

This regenerates .claude/skills and .claude/commands from the flat source; keep them untracked.

</details> <details> <summary>Claude.ai / Claude Desktop</summary>

Download pm-skills-vX.X.X.zip from Releases
Upload in Claude.ai or Desktop:
- Claude.ai: Project Settings → Add Files → Upload ZIP
- Desktop: Settings → Capabilities → Upload ZIP
Use skills by name: "Use the prd skill to create requirements for..."

See QUICKSTART.md in the archive for detailed instructions.

</details>  <details> <summary>MCP Server (Claude Desktop, Cursor, Any MCP Client)</summary>

For MCP-compatible clients, use pm-skills-mcp:

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

All 26 domain and foundation skills become available as programmatic tools (the utility skill is designed for Claude Code environments). See the pm-skills-mcp README for client-specific setup.

</details>  <details> <summary>GitHub Copilot</summary>

Copilot auto-discovers skills via AGENTS.md:

# Clone into your project or as a submodule
git clone https://github.com/product-on-purpose/pm-skills.git

# Or add as submodule
git submodule add https://github.com/product-on-purpose/pm-skills.git

Copilot Chat will see the skills. Ask: "Use the prd skill to create requirements for user authentication"

Setup checklist:

Open a workspace that includes pm-skills (repo root or submodule).
Use Copilot Chat in agent/workspace context.
Invoke skills by name, for example: Use the hypothesis skill for checkout abandonment.

</details> <details> <summary>OpenCode</summary>

OpenCode can load PM-Skills directly from this repository:

git clone https://github.com/product-on-purpose/pm-skills.git
cd pm-skills

Setup checklist:

Configure OpenCode to use this folder as a skills source.
If your OpenCode flow expects .claude/skills/, run ./scripts/sync-claude.sh (or .ps1) once after clone.
Invoke by skill name (example: Use the prd skill for ...).

</details> <details> <summary>Cursor / Windsurf</summary>

Both IDEs auto-discover skills via AGENTS.md:

# Clone into your workspace
git clone https://github.com/product-on-purpose/pm-skills.git

Open the folder in Cursor or Windsurf. The AI assistant will automatically discover and can use all 38 skills.

</details> <details> <summary>VS Code (Cline / Continue)</summary>

With Cline or Continue extensions:

Clone pm-skills into your workspace
The extension will discover skills via AGENTS.md
Ask: "Use the hypothesis skill to test my assumption about..."

Manual approach:

Open any SKILL.md file from skills/{phase-skill}/ (e.g., skills/deliver-prd/)
Copy the content into your AI chat
Ask the AI to follow the skill instructions

</details> <details> <summary>ChatGPT / Other LLMs</summary>

ChatGPT and other LLMs don't support Agent Skills natively, but you can use skills manually:

Clone or download pm-skills
Open the skill you need (e.g., skills/deliver-prd/SKILL.md)
Copy the full content into your ChatGPT conversation
Ask: "Follow these instructions to create a PRD for [your topic]"

The skill content provides all the context the LLM needs to produce professional output.

</details>

Releases

All releases are available on the GitHub Releases page:

pm-skills-vX.X.X.zip — Complete package with all skills, commands, workflows, and documentation
Latest stable: v2.10.2 (Plugin manifest drift fix and count-consistency CI hardening)
Latest release notes: CHANGELOG.md
Published tag: v2.10.2
Documentation site: product-on-purpose.github.io/pm-skills

Each release includes QUICKSTART.md with installation and usage instructions. Release notes are published in docs/releases/ (for example, docs/releases/Release_v2.2.md).

Alternative: openskills CLI

Note: The openskills CLI discovers skills in .claude/skills/ directories. PM-Skills ships a flat skills/{phase-skill}/ structure plus a sync helper that populates .claude/skills/ locally. Run ./scripts/sync-claude.sh (or .ps1) after cloning to enable discovery.

# Works for repos with .claude/skills/ structure (e.g., anthropics/skills)
npm i -g openskills
openskills install anthropics/skills
openskills sync

(<a href="#readme-top">back to top</a>)

Usage

PM-Skills provides three components that work together to accelerate your product management work:

Component	What it is	When to use
Skills	Self-contained instruction sets with templates and examples	Single artifacts (PRD, user stories, retro)
Commands	Slash commands for Claude Code (e.g., `/prd`)	Quick access to individual skills
Workflows	Curated multi-skill processes	End-to-end processes (feature kickoff, validation cycles)

Skills are the atomic building blocks-each one teaches your AI how to produce a specific PM artifact with professional quality. Commands give you instant access to skills via /skill-name syntax. Workflows chain multiple skills together for complete product development processes.

How Skills Work

Each skill is a self-contained instruction set:

skills/{phase-skill}/
├── SKILL.md              # Instructions for the AI
└── references/
    ├── TEMPLATE.md       # Output structure
    └── EXAMPLE.md        # Real-world example

Your prompt: "Create a PRD for adding dark mode to our app"

The AI:

Reads skills/{phase-skill}/SKILL.md for instructions
Follows the structured approach (problem → solution → metrics → scope)
Uses TEMPLATE.md for formatting
References EXAMPLE.md for quality benchmarks
Outputs a complete, professional PRD

The Skills

PM-Skills covers the complete product lifecycle using the Triple Diamond framework (25 phase skills) plus foundation and utility capabilities:

🔍 Discover - Find the right problem

Skill	What it does	Command
interview-synthesis	Turn user research into actionable insights	`/interview-synthesis`
competitive-analysis	Map the landscape, find opportunities	`/competitive-analysis`
stakeholder-summary	Understand who matters and what they need	`/stakeholder-summary`

📋 Define - Frame the problem

Skill	What it does	Command
problem-statement	Crystal-clear problem framing	`/problem-statement`
hypothesis	Testable assumptions with success metrics	`/hypothesis`
opportunity-tree	Teresa Torres-style outcome mapping	`/opportunity-tree`
jtbd-canvas	Jobs to be Done framework	`/jtbd-canvas`

💡 Develop - Explore solutions

Skill	What it does	Command
solution-brief	One-page solution pitch	`/solution-brief`
spike-summary	Document technical explorations	`/spike-summary`
adr	Architecture Decision Records (Nygard format)	`/adr`
design-rationale	Why you made that design choice	`/design-rationale`

🚀 Deliver - Ship it

Skill	What it does	Command
prd	Comprehensive product requirements	`/prd`
user-stories	INVEST-compliant stories with acceptance criteria	`/user-stories`
acceptance-criteria	Given/When/Then testable scenarios	`/acceptance-criteria`
edge-cases	Error states, boundaries, recovery paths	`/edge-cases`
launch-checklist	Never miss a launch step again	`/launch-checklist`
release-notes	User-facing release communication	`/release-notes`

📊 Measure - Validate with data

Skill	What it does	Command
experiment-design	Rigorous A/B test planning	`/experiment-design`
instrumentation-spec	Event tracking requirements	`/instrumentation-spec`
dashboard-requirements	Analytics dashboard specs	`/dashboard-requirements`
experiment-results	Document learnings from experiments	`/experiment-results`

🔄 Iterate - Learn and improve

Skill	What it does	Command
retrospective	Team retros that drive action	`/retrospective`
lessons-log	Build organizational memory	`/lessons-log`
refinement-notes	Capture backlog refinement outcomes	`/refinement-notes`
pivot-decision	Evidence-based pivot/persevere framework	`/pivot-decision`

🧭 Foundation - Cross-cutting capability

Skill	What it does	Command
persona	Generate product or marketing personas with evidence and confidence	`/persona`

🔧 Utility - Meta-tooling

Skill	What it does	Command
pm-skill-builder	Create new PM skills with gap analysis and guided drafting	`/pm-skill-builder`
pm-skill-validate	Audit a skill against structural conventions and quality criteria	`/pm-skill-validate`
pm-skill-iterate	Apply targeted improvements from feedback or validation reports	`/pm-skill-iterate`
mermaid-diagrams	Create syntactically valid mermaid diagrams for product documents	`/mermaid-diagrams`
slideshow-creator	Generate professional presentations from JSON deck specs	`/slideshow-creator`
update-pm-skills	Check for updates and update local pm-skills installation	`/update-pm-skills`

Quick Examples

Generate a comprehensive PRD:

/prd "Add real-time collaboration to document editor"

Create user stories from requirements:

/user-stories "Dark mode feature from PRD.md"

Design an A/B test:

/experiment-design "Test impact of simplified onboarding flow"

Document a technical decision:

/adr "Decision to use PostgreSQL for primary database"

Synthesize user research:

/interview-synthesis "5 customer interviews about payment flows"

Workflows

While individual skills are powerful on their own, real product work rarely happens in isolation. Workflows combine multiple skills into guided, end-to-end processes that mirror how experienced product managers actually work.

Each workflow provides a sequence of skills with handoff guidance between steps, ensuring context flows naturally from discovery through delivery. Workflows are opinionated-they encode PM best practices about which artifacts to create and in what order.

Don't know where to start? Use a workflow:

Workflow	Best for	Skills included
Feature Kickoff	New features	problem-statement → hypothesis → prd → user-stories → launch-checklist
Lean Startup	Rapid validation	hypothesis → experiment-design → experiment-results → pivot-decision
Triple Diamond	Major initiatives	Full 25 phase-skill flow across 6 phases
Customer Discovery	Research synthesis	Transform raw research into a validated problem
Sprint Planning	Sprint prep	Prepare sprint-ready stories from a backlog
Product Strategy	Strategic initiatives	Frame a major strategic initiative
Post-Launch Learning	Post-launch	Measure results and capture learnings after launch
Stakeholder Alignment	Leadership buy-in	Build a case for leadership buy-in
Technical Discovery	Tech feasibility	Evaluate technical feasibility and architecture

Workflow Examples

For new features, use the Feature Kickoff workflow:

/workflow-feature-kickoff "Mobile push notifications"

This automatically executes:

problem-statement - Frame the problem
hypothesis - Define testable assumptions
prd - Create comprehensive requirements
user-stories - Generate implementation stories
launch-checklist - Plan the launch

For rapid validation, use the Lean Startup workflow:

Build → Measure → Learn cycle with hypothesis, experiments, and pivot decisions

For major initiatives, use the Triple Diamond workflow:

Complete product development across all 6 phases and 25 phase skills

For detailed skill documentation and examples, see the skills/ directory.

(<a href="#readme-top">back to top</a>)

Project Status

Project Structure

pm-skills/
├── skills/                     # 38 PM skills (25 phase + 7 foundation + 6 utility)
├── commands/                   # Slash commands (45) mapping to skills/workflows
├── _workflows/                 # 9 workflows: feature-kickoff, lean-startup, triple-diamond, and 6 more
├── library/                    # Sample output library (skill-output-samples) and related corpus docs
├── scripts/                    # sync-claude.(sh|ps1), build-release.(sh|ps1), validate-commands.(sh|ps1)
├── .github/                    # CI workflows + automation scripts (validate-mcp-sync)
├── docs/                       # Documentation and guides
│   ├── getting-started.md      # Setup guide
│   ├── guides/                 # How-to guides (using-skills.md, authoring-pm-skills.md, mcp-integration.md)
│   ├── reference/              # Technical specs (categories.md, ecosystem.md, project-structure.md)
│   └── templates/              # Skill template (SKILL.md, TEMPLATE.md, EXAMPLE.md)
├── AGENTS.md                   # Universal agent discovery file
├── CONTRIBUTING.md             # Contribution guidelines
└── CHANGELOG.md                # Version history

See docs/reference/project-structure.md for detailed descriptions.

Previous Release Details

<details> <summary>v2.5.x - Persona skill + foundation/utility taxonomy</summary>

v2.5.2 — Public release-doc readability and hygiene:

Public release docs rewritten in user-first language.
No skill, command, template, or workflow behavior changes.
Release note: docs/releases/Release_v2.5.2.md.

v2.5.1 — Agent workspace canonicalization:

Canonical AGENTS/claude workspace + clean-worktree cut/tag/publish runbook.
Release note: see CHANGELOG.md.

v2.5.0 — Persona + foundation/utility + sample library:

Persona skill shipment + foundation/utility taxonomy + sample output library.
Content-alignment checks for the sample library complete and documented.
Release note: docs/releases/Release_v2.5.0.md.

</details> <details> <summary>v2.4.x - Contract lock closure + governance</summary>

v2.4.3 — Release metadata/link alignment patch. v2.4.2 — Governance and tracked-vs-local artifact hygiene. v2.4.1 — Docs/release alignment follow-up. v2.4.0 — Output and configuration contract lock closure.

Release notes: docs/releases/Release_v2.4.md through Release_v2.4.3.md.

</details> <details> <summary>v2.2.0–v2.3.0 - MCP sync guardrails + governance baseline</summary>

v2.3.0 — MCP sync guardrail defaults to blocking mode. v2.2.0 — Cross-repo sync checker (observe mode), planning/backlog governance.

Release notes: docs/releases/Release_v2.2.md, Release_v2.3.md.

</details> <details> <summary>v2.0.x and earlier</summary>

v2.0.x — Flat skill layout (skills/{phase-skill}/), sync helpers, build scripts, docs refresh. v1.x — Security hardening, CI governance, documentation baseline, slash-command completion. v0.x — Initial repository scaffolding and early phased skill build-out.

See CHANGELOG.md for dated release-by-release detail.

</details>

Changelog

See CHANGELOG.md for full details.

Version	Date	Highlights
2.9.0	2026-04-06	Workflows: rename bundles → workflows + expand 3 → 9, 7 `/workflow-*` commands, URL redirects
2.8.2	2026-04-04	Docs site polish + versioning concepts page
2.8.1	2026-04-04	MkDocs Material documentation site launch
2.8.0	2026-04-03	PM skill lifecycle: `pm-skill-validate`, `pm-skill-iterate`, lifecycle guide, skill versioning
2.7.0	2026-03-22	Utility skills (`pm-skill-builder`), `acceptance-criteria` skill, enhanced CI, release packaging hygiene, docs refresh
2.6.1	2026-03-04	Sample-library recovery, naming/path normalization, and release ZIP inclusion
2.6.0	2026-03-04	Claude plugin packaging release with staged manifest version checks
2.5.2	2026-03-04	Public release-doc readability and hygiene patch (user-first wording, no local-only path references)
2.5.1	2026-03-04	Canonical `AGENTS/claude` workspace + clean-worktree cut/tag/publish runbook
2.5.0	2026-03-02	Persona skill shipment + foundation/utility taxonomy + sample-library quality closure
2.4.3	2026-02-16	Patch release to include post-`v2.4.2` documentation/release-link updates
2.4.2	2026-02-16	Governance/artifact-placement patch + v2.5 continuity kickoff docs
2.4.1	2026-02-16	Docs/release-alignment patch follow-up (no contract behavior changes)
2.4.0	2026-02-16	Output and configuration contract lock closure + release cut
2.3.0	2026-02-13	MCP alignment closure + blocking-default sync guardrail
2.2.0	2026-02-13	MCP drift guardrail (observe mode), planning/backlog governance, release execution checklists
2.1.0	2026-01-27	MCP alignment milestone documentation update
2.0.0	2026-01-26	Flat `skills/{phase-skill}/`, sync helpers, build scripts, docs refresh
1.2.0	2026-01-20	Security policy, CodeQL scanning, Dependabot, issue/PR templates
1.1.1	2026-01-20	openskills#48 fix verified, CODE_OF_CONDUCT, open-skills submissions
1.1.0	2026-01-16	Documentation overhaul, README redesign, FAQ, collapsible TOC
1.0.1	2026-01-15	Slash-command baseline completion for the initial shipped skill set
1.0.0	2026-01-14	First stable Triple Diamond baseline, workflows, and AGENTS.md
0.3.0	2026-01-14	P1 skill-lane expansion and GitHub Actions workflow setup
0.2.0	2026-01-14	P0 core-skill baseline and early project structure
0.1.0	2026-01-14	Initial project structure, foundation infrastructure

(<a href="#readme-top">back to top</a>)

Milestones

Maintenance milestone documentation:

2026-03 baseline cleanup

Roadmap

See the open issues for a full list of proposed features and known issues.

Launch with 32 shipped skills (25 phase skills + 1 foundation skill + 6 utility skills)
Add workflows (Feature Kickoff, Lean Startup, Triple Diamond)
GitHub Copilot, Cursor, and Windsurf integration via AGENTS.md
Slash commands for Claude Code
Apache 2.0 license for commercial use
openskills CLI support (#48 resolved in v1.3.1)
pm-skills-mcp package (https://github.com/product-on-purpose/pm-skills-mcp) with v2.4 direct-version-tracking milestone documented
v2.2 guardrails release: observe-first cross-repo sync validation + planning/backlog governance
v2.4 contract lock release: output behavior and configuration contracts closed and validated

In Progress

Documentation, examples, and ecosystem polish for shipped surfaces
Contributor-facing guidance and schema alignment follow-up

Backlog / Considering

Top Feature Requests

Coming soon

Top Bugs

Coming soon

(<a href="#readme-top">back to top</a>)

Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make will benefit everybody else and are greatly appreciated.

How to Contribute

Quick contribution steps:

Fork the Project
Create your Feature Branch (git checkout -b feature/AmazingSkill)
Commit your Changes using Conventional Commits (git commit -m 'feat: add amazing skill')
Push to the Branch (git push origin feature/AmazingSkill)
Open a Pull Request

Please read our CONTRIBUTING.md for detailed guidelines on:

Code of conduct
Development process
Skill contribution guidelines
Testing requirements
Documentation standards

Reporting Bugs

Please try to create bug reports that are:

✅ Reproducible - Include steps to reproduce the problem
✅ Specific - Include as much detail as possible (version, environment, etc.)
✅ Unique - Do not duplicate existing opened issues
✅ Scoped - One bug per report

(<a href="#readme-top">back to top</a>)

FAQ

<details> <summary>Do I need to install all 38 skills?</summary>

No! You can use individual skills as needed. Each skill is self-contained and works independently. If you only need PRDs, just reference the skills/deliver-prd/ skill. The workflows are optional guides, not requirements.

</details> <details> <summary>Can I use PM-Skills with ChatGPT?</summary>

Yes, with some limitations. You can copy the contents of any SKILL.md file into your ChatGPT conversation as context. However, ChatGPT doesn't support the Agent Skills Specification natively, so you won't get automatic skill discovery or slash commands. For the best experience, we recommend Claude, GitHub Copilot, Cursor, or Windsurf.

</details> <details> <summary>How do I customize a skill for my team?</summary>

Fork the repository and modify the SKILL.md, TEMPLATE.md, or EXAMPLE.md files to match your team's standards. You can add company-specific sections, change terminology, or adjust the output format. The Apache 2.0 license allows commercial use and modification.

</details> <details> <summary>What's the difference between skills and workflows?</summary>

Skills are atomic units-each produces one PM artifact (a PRD, a hypothesis, user stories, etc.). Workflows chain multiple skills together in a recommended sequence. Use skills when you need a specific output; use workflows when you want guided end-to-end processes.

</details> <details> <summary>Why doesn't PM-Skills work with openskills CLI?</summary>

The openskills CLI discovers skills in .claude/skills/ directories. PM-Skills now ships flat skills/{phase-skill}/ plus foundation capabilities and a sync helper that populates .claude/skills/ locally. Clone the repo, run ./scripts/sync-claude.sh (or .ps1), and openskills/Claude Code will discover all shipped skills.

</details> <details> <summary>Can I contribute new skills?</summary>

Absolutely! Check out our authoring guide for the full process. We use a curated contribution model-submit a proposal via GitHub issue first, then create your skill following our template structure. All contributions are reviewed for quality and alignment with PM best practices.

</details> <details> <summary>How do slash commands work in Claude Code?</summary>

Slash commands (like /prd or /hypothesis) are shortcuts that invoke the corresponding skill. When you type /prd \"my feature\", Claude Code reads the skill instructions from skills/deliver-prd/SKILL.md and generates output following the template. No additional setup required-the commands are defined in the commands/ directory.

</details>  <details> <summary>What's the difference between pm-skills and pm-skills-mcp?</summary>

pm-skills (this repo) is the source skill library with all 38 PM skills as markdown files. It's best for Claude Code slash commands, file browsing, and customization.

pm-skills-mcp wraps these same skills in an MCP server for programmatic access. It's best for Claude Desktop, Cursor, and any MCP-compatible client.

Both give you access to identical skills—choose based on your preferred client and workflow. See the Ecosystem Overview for a detailed comparison.

</details>  (<a href="#readme-top">back to top</a>)

About

Author

Howdy, I'm Jonathan Prisant, a product leader/manager/nerd in the church technology space who gets unreasonably excited about understanding + solving problems, serving humans, designing elegant systems, and getting stuff done. I enjoy optimizing and scaling workflows more than is probably healthy... NOT because I'm particularly fond of "business process definition", but because I think in systems and value the outcomes of increased "effectiveness and efficiency" (i.e. doing less of the boring work and more of the work I actually enjoy).

I am a follower of Jesus Christ, grateful husband to my beloved, proud (and exhausted) daddy, D&D geek, 3d printing enthusiast, formerly-consistent strength trainer, smart home enthusiast, insatiable learner, compulsive tech-experimenter, writer-of-words that aggregate into sentences and paragraphs, and a bunch of other stuff too. I have too many projects going on across too many domains and need better self control, but hopefully you find this open-source repo helpful and useful.

If PM-Skills has helped you ship better products, consider giving the repo a star and sharing it with your team.

License

Distributed under the Apache License 2.0. See LICENSE for more information.

This means you can:

Use PM-Skills commercially
Modify and distribute
Use privately
Include in proprietary software

The only requirements are attribution and including the license notice.

(<a href="#readme-top">back to top</a>)

Community

Have ideas for making PM-Skills even better? Here are some ways to contribute and connect:

Feature Ideas

Open a feature request to suggest new skills or improvements
Join the Discussions to brainstorm with the community

Skill Contributions

Check out our authoring guide to create your own skills
Review the skill template for the expected structure

Spread the Word

Give the repo a star if you find it useful
Share PM-Skills on Twitter, LinkedIn, or your favorite PM community
Write a blog post about how you use PM-Skills in your workflow

Feedback

Found something confusing? Open an issue
Want to chat? Start a discussion

Built with purpose by <a href="https://github.com/product-on-purpose">Product on Purpose</a> Helping teams ship better products with AI-powered PM workflows (<a href="#readme-top">back to top</a>)

The Big Idea

The Problem

The Solution

Key Features

Skill Lifecycle Tools

Built with...

Founded on...

Works for...

Platform Compatibility

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

Getting Started

Install as Claude Code Plugin

Installation Options

Quick Start by Platform

Releases

Alternative: openskills CLI

Usage

How Skills Work

The Skills

🔍 Discover - Find the right problem

📋 Define - Frame the problem

💡 Develop - Explore solutions

🚀 Deliver - Ship it

📊 Measure - Validate with data

🔄 Iterate - Learn and improve

🧭 Foundation - Cross-cutting capability

🔧 Utility - Meta-tooling

Quick Examples

Workflows

Workflow Examples

Project Status

Project Structure

Previous Release Details

Changelog

Milestones

Roadmap

Backlog / Considering

Top Feature Requests

Top Bugs

Contributing

How to Contribute

Reporting Bugs

FAQ

About

Author

License

Community

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