- Quick Start
- Recent Updates
- The Big Idea
- Installation and Setup
- How Agent Skills Work
- The Skill Library
- Library Examples
- Learning and Resources
- Project Status
- Contributing
- Community
- FAQ
- About the Author
Quick Start
After installing, you'll have all 68 skills available (invoke any by name, like /pm-skills:deliver-prd, /pm-skills:define-hypothesis, /pm-skills:deliver-user-stories) plus 10 /workflow-* orchestrator commands and the /chain ad-hoc runner, templates, sub-agents, and 200+ sample outputs.
Claude Code (recommended):
/plugin marketplace add product-on-purpose/agent-plugins
/plugin install pm-skills@product-on-purpose
Already installed via the old
pm-skills-marketplace? It keeps working - no action needed. To move to the new home, see the v2.21.0 release notes.
Cross-agent (Cursor, Copilot, Cline, and others via the open skills CLI):
npx skills add product-on-purpose/pm-skills
Clone or download:
git clone https://github.com/product-on-purpose/pm-skills.git
More resources:
- Getting Started Guide - Detailed walkthrough for new users covering clone, sync helper, and first skill run. The path to take if any of the quick start steps above leave gaps.
- Setup by Platform - Step-by-step install for Claude.ai, Codex, Cursor, Windsurf, GitHub Copilot, VS Code extensions, and ChatGPT.
- Quickstart Reference - Short-form reference card for users who just need the commands.
Recent Updates
The companion pm-skills-mcp server is in the v2.9.x maintenance line (latest v2.9.3) and remains available on npm for clients that need MCP transport. The catalog is frozen at the v2.9.2 build; subsequent v2.9.x patches do not change the catalog. Active development on the MCP server is paused; security patches and critical bug fixes will continue.
Recommendation: For new users, we recommend using the plugin. See Installation and Setup for other options.
What's New
| Version | Date | Highlights |
|---|---|---|
| v2.31.0 | 2026-07-05 | Zero-drift releases: generation becomes the only write path. See CHANGELOG. |
| v2.30.0 | 2026-07-04 | Trust repair + hygiene. See CHANGELOG. |
| v2.29.1 | 2026-06-24 | Maintenance patch: skill docs pages no longer drop sections. See CHANGELOG. |
Full history: CHANGELOG.md or all GitHub Releases.
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 gives your AI instant access to professional frameworks refined across hundreds of product launches, production-ready templates that capture institutional PM knowledge, and real-world examples that set the quality bar.
| 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 |
Who Is This For
| You are... | PM-Skills gives you... |
|---|---|
| A solo PM using AI for the first time | A starting point that skips prompt engineering and produces professional output immediately |
| A team lead standardizing PM output | Shared skill library your whole team invokes the same way, producing consistent artifacts |
| An AI/PM builder creating PM tools | Open-source, Apache 2.0 library of production-quality PM artifacts to build on |
Key Features
- ✅ 68 Production-Ready Skills covering the complete product lifecycle (30 phase skills + 11 foundation skills + 12 utility skills + 15 tool skills for structured workshop methodologies)
- ✅ Triple Diamond Framework organizing Discover, Define, Develop, Deliver, Measure, and Iterate phases
- ✅ Tool Families for the Foundation Sprint (2-day strategic alignment) and Design Sprint (5-day prototype-and-test) workshop methodologies
- ✅ 5 Active Orchestration Sub-Agents (pm-critic, pm-skill-auditor, pm-changelog-curator, pm-release-conductor, pm-workflow-orchestrator) for Claude Code, with dispatch skills extending the pattern to Codex, Cursor, Windsurf, Copilot, and Gemini CLI
- ✅ 12 Workflows for common PM processes including Feature Kickoff, Lean Startup, Triple Diamond, and foundation-to-design end-to-end arc
- ✅ 10 Workflow Commands for Claude Code users - plus every skill invocable directly by name
- ✅ Auto-Discovery via AGENTS.md in GitHub Copilot, Cursor, and Windsurf
- ✅ Agent Skills Spec compliant - works across AI assistants
- ✅ Apache 2.0 Licensed for commercial and personal use
Skill Lifecycle Tools = Custom Skill Builder
PM-Skills includes three utility skills that form a complete Create - Validate - Iterate lifecycle for building and managing skills:
%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#fffbeb', 'primaryBorderColor': '#fde68a', 'lineColor': '#92400e'}}}%%
flowchart LR
classDef create fill:#ea580c,stroke:#c2410c,color:#fff,font-weight:bold
classDef validate fill:#0284c7,stroke:#0369a1,color:#fff,font-weight:bold
classDef decision fill:#374151,stroke:#1f2937,color:#fff
classDef ship fill:#166534,stroke:#14532d,color:#fff,font-weight:bold
classDef iterate fill:#7c3aed,stroke:#6d28d9,color:#fff,font-weight:bold
Create["utility-pm-skill-builder<br/>Create new skill<br/>from an idea"]:::create
Validate["utility-pm-skill-validate<br/>Audit structure<br/>and quality"]:::validate
Decision{"Findings?"}:::decision
Ship["Ship<br/>to library"]:::ship
Iterate["utility-pm-skill-iterate<br/>Apply targeted<br/>improvements"]:::iterate
Create --> Validate
Validate --> Decision
Decision -- "PASS" --> Ship
Decision -- "WARN / FAIL" --> Iterate
Iterate --> Validate
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.
| Tool & Command | What it does |
|---|---|
Builder: /pm-skills:utility-pm-skill-builder |
Creates a new skill from an idea. Runs gap analysis against existing skills, classifies by type and phase, generates draft files to a staging area, and promotes on confirmation. |
Validator: /pm-skills:utility-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-skills:utility-pm-skill-iterate |
Applies targeted improvements to a skill based on feedback or a validation report. Previews changes, writes on confirmation, and suggests a version bump. |
🔗 More resources:
- PM Skill Lifecycle Guide - Full workflow for creating, validating, and iterating skills, including the builder-validator-iterator cycle with worked examples.
- Creating PM Skills - Authoring guide for contributing new skills to the library.
- Skill Template - The canonical three-file template every skill must follow; copy this as your starting point.
Founded On
- Triple Diamond Framework - Six-phase product cycle (extends Design Council's Double Diamond): Discover, Define, Develop, Deliver, Measure, Iterate
- Opportunity Solution Trees (Teresa Torres) - Outcome-driven discovery
- Jobs to be Done Framework - Customer motivation framework
- Foundation Sprint (Knapp/Zeratsky) - 2-day structured workshop methodology for early-stage strategic alignment: basics, differentiation, approach options, magic lenses, founding hypothesis, brief
- Design Sprint (Knapp/Zeratsky/Kowitz) - 5-day structured workshop methodology for prototype-and-test cycles: map-and-target, sketch, decide-and-storyboard, prototype-plan, test-and-score
- Architecture Decision Records (Michael Nygard format) - Technical decision documentation
Installation and Setup
Tool Compatibility
| Platform | Native Skills? | Notes |
|---|---|---|
| Claude Code | ✅ Yes | Plugin marketplace + 10 workflow commands |
| GitHub Copilot | ✅ Yes | AGENTS.md auto-discovery from clone |
| Cursor | ✅ Yes | AGENTS.md auto-discovery from clone |
| Windsurf | ✅ Yes | AGENTS.md auto-discovery from clone |
| Codex (OpenAI) | ✅ Yes | AGENTS.md auto-discovery from clone |
| OpenCode | ✅ Yes | Direct skill loading from clone |
| VS Code (Cline, Continue) | ✅ Yes | AGENTS.md auto-discovery from clone |
| Claude.ai / Claude Desktop | ✔️ Manual | ZIP upload to Project Files |
| ChatGPT / other LLMs | ✔️ Manual | Paste SKILL.md content into conversation |
Featured Install Paths
Claude Code - Plugin Marketplace (recommended)
/plugin marketplace add product-on-purpose/agent-plugins
/plugin install pm-skills@product-on-purpose
Already installed via the old
pm-skills-marketplace? It keeps working - no action needed. To move to the new home, see the v2.21.0 release notes.
All 68 skills and their slash commands become available immediately. No clone required.
Cross-Agent via skills CLI (Cursor, Copilot, Cline, and others)
npx skills add product-on-purpose/pm-skills
The open skills CLI from Vercel Labs scans the skills/ directory and installs all 68 skills into your agent's default skills directory. Works with Claude Code, Cursor, GitHub Copilot, Cline, and any other agent that supports the skills ecosystem. Discoverable via skills.sh/product-on-purpose/pm-skills.
Telemetry is anonymous and opt-out via DISABLE_TELEMETRY=1 or DO_NOT_TRACK=1.
Git Clone (manual path, everything included)
git clone https://github.com/product-on-purpose/pm-skills.git
cd pm-skills
Gives you the full repo: skill files, slash commands, sample library, workflows, and documentation. Use this path when you want local access to sample outputs, plan to customize skills, or prefer not to depend on a CLI.
Optional: after cloning, run ./scripts/sync-claude.sh (macOS/Linux) or ./scripts/sync-claude.ps1 (Windows) to populate .claude/skills/ for agents that use that discovery path.
Additional Install Methods
For Claude.ai, MCP clients, OpenCode, Windsurf, and ChatGPT, see the full Platform Setup Guide for step-by-step instructions.
| Platform | How | Guide |
|---|---|---|
| Claude.ai / Claude Desktop | ZIP upload to Project Files | Platform guide |
| MCP Server (any MCP client) | npx pm-skills-mcp |
pm-skills-mcp repo |
| GitHub Copilot | AGENTS.md auto-discovery from clone | Platform guide |
| OpenCode | Direct skill loading from clone | Platform guide |
| Cursor / Windsurf | AGENTS.md auto-discovery | Platform guide |
| VS Code (Cline / Continue) | AGENTS.md auto-discovery | Platform guide |
| ChatGPT / other LLMs | Copy SKILL.md into conversation | Platform guide |
More resources:
- Getting Started Guide - Detailed walkthrough for new users covering all install methods, the sync helper script, and your first skill run end-to-end.
- Quickstart Reference - Short-form reference card with just the essential commands.
How Agent Skills Work
Each skill is a self-contained instruction set in three files:
%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#f8fafc', 'primaryBorderColor': '#cbd5e1', 'lineColor': '#64748b'}}}%%
flowchart LR
classDef user fill:#1e293b,stroke:#0f172a,color:#f8fafc,font-weight:bold
classDef agent fill:#4f46e5,stroke:#3730a3,color:#fff,font-weight:bold
classDef skillFile fill:#7c3aed,stroke:#5b21b6,color:#fff
classDef templateFile fill:#0284c7,stroke:#0369a1,color:#fff
classDef exampleFile fill:#059669,stroke:#047857,color:#fff
classDef output fill:#166534,stroke:#14532d,color:#fff,font-weight:bold
User["You<br/>deliver-prd 'topic'"]:::user
Agent["Your Agent"]:::agent
SKILL["SKILL.md<br/>the method"]:::skillFile
TEMPLATE["TEMPLATE.md<br/>the structure"]:::templateFile
EXAMPLE["EXAMPLE.md<br/>the quality bar"]:::exampleFile
Output["Complete artifact"]:::output
User -- invokes --> Agent
Agent -- reads --> SKILL
Agent -- fills --> TEMPLATE
Agent -- mirrors --> EXAMPLE
SKILL --> Output
TEMPLATE --> Output
EXAMPLE --> Output
skills/deliver-prd/
SKILL.md # the method the agent reads
references/
TEMPLATE.md # the structure the output follows
EXAMPLE.md # the worked example that anchors quality
When you run /pm-skills:deliver-prd "topic", the agent loads the skill, mirrors the example, fills the template, and produces a complete PRD. No prompt engineering required.
| Property | What it gives you |
|---|---|
| Declarative | The skill says what a good PRD is, not how to phrase a prompt |
| Example-anchored | The worked example sets the quality bar; the agent mirrors depth and structure |
| Structurally contracted | The template enforces sections-present and sections-complete |
🔗 More resources:
- PM Skill Anatomy - Deep dive into the three-file structure (SKILL.md, TEMPLATE.md, EXAMPLE.md) and what each file contributes to output quality. Essential reading before authoring your first skill.
- Skill Finder - Decision guide for choosing the right skill when you know the outcome you need but aren't sure which skill produces it.
- PM Skill Comparisons - Side-by-side comparison of overlapping skills. Prevents the common mistake of reaching for
problem-statementwhenopportunity-treeis the right fit. - Sub-Agents - Claude Code also supports spawnable specialist agents for tasks that benefit from a dedicated agent context: adversarial review, catalog auditing, changelog curation, and release orchestration.
The Skill Library
At a Glance
%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#f0f4ff', 'primaryBorderColor': '#c7d2fe', 'lineColor': '#6b7280', 'clusterBkg': '#f8fafc', 'clusterBorder': '#e2e8f0'}}}%%
flowchart TB
classDef discover fill:#0891b2,stroke:#0e7490,color:#fff,font-weight:bold
classDef define fill:#7c3aed,stroke:#6d28d9,color:#fff,font-weight:bold
classDef develop fill:#d97706,stroke:#b45309,color:#fff,font-weight:bold
classDef deliver fill:#16a34a,stroke:#15803d,color:#fff,font-weight:bold
classDef measure fill:#dc2626,stroke:#b91c1c,color:#fff,font-weight:bold
classDef iterate fill:#9333ea,stroke:#7e22ce,color:#fff,font-weight:bold
classDef tool fill:#0284c7,stroke:#0369a1,color:#fff
classDef foundation fill:#059669,stroke:#047857,color:#fff
classDef utility fill:#ea580c,stroke:#c2410c,color:#fff
subgraph PHASE["Triple Diamond Phase Skills (30)"]
direction LR
DI["Discover<br/>5 skills"]:::discover
DE["Define<br/>5 skills"]:::define
DEV["Develop<br/>4 skills"]:::develop
DEL["Deliver<br/>6 skills"]:::deliver
ME["Measure<br/>6 skills"]:::measure
IT["Iterate<br/>4 skills"]:::iterate
DI --> DE --> DEV --> DEL --> ME --> IT
IT -."feedback loop".-> DI
end
subgraph WORKSHOP["Workshop Tool Families (15 skills)"]
direction LR
FS["Foundation Sprint<br/>7 skills<br/>2-day strategic alignment"]:::tool
DS["Design Sprint<br/>7 skills<br/>5-day prototype-and-test"]:::tool
NV["note-and-vote<br/>1 skill<br/>standalone mechanic"]:::tool
FS --> DS
end
subgraph SUPPORT["Cross-Cutting Capabilities (23 skills)"]
direction LR
FOUND["Foundation<br/>11 skills<br/>persona, lean-canvas,<br/>OKRs, meetings"]:::foundation
UTIL["Utility<br/>12 skills<br/>meta-tooling"]:::utility
end
PHASE -.uses.-> SUPPORT
WORKSHOP -.uses.-> SUPPORT
| Classification | Count | What's in it |
|---|---|---|
| Phase (Triple Diamond) | 30 | One skill per major PM activity across Discover, Define, Develop, Deliver, Measure, and Iterate |
| Foundation (cross-cutting) | 11 | Persona, lean canvas, OKRs, prioritized action plan, stakeholder briefings, and the full meeting skills family |
| Utility (meta-tooling) | 12 | pm-skill-builder, pm-skill-validate, pm-skill-iterate, pm-workflow-builder, pm-workflow-orchestrator, mermaid-diagrams, slideshow-creator, update-pm-skills, and helpers |
| Tool Families (workshop methods) | 15 | Foundation Sprint family (7) + Design Sprint family (7) + note-and-vote (1) |
Foundation Skills - Cross-cutting capability (11)
| Skill | What it does |
|---|---|
| persona | Generate product or marketing personas with evidence and confidence ratings |
| lean-canvas | Capture problem, customer segment, value proposition, and key metrics on one page |
| okr-writer | Draft an objectives-and-key-results plan with tight, measurable key results |
| stakeholder-update | Compose a stakeholder-facing update from project state and recent activity |
| meeting-agenda | Draft a focused agenda from purpose, attendees, and time-box |
| meeting-brief | One-page brief priming attendees with context and pre-reads |
| meeting-recap | Synthesize a meeting transcript into decisions, actions, and follow-ups |
| meeting-synthesize | Cross-meeting synthesis distilling themes from multiple sessions |
| prioritized-action-plan | Turn any PM input into an evidence-grounded prioritized action plan via Theory of Constraints and Cynefin |
| stakeholder-briefings | Fan any source artifact into a master document plus audience-tailored briefings, one per stakeholder lens, each a traceable projection of the master |
Phase Skills: Triple Diamond
Discover - Find and assess the right problem (5)
| Skill | What it does |
|---|---|
| interview-synthesis | Turn raw user research into actionable insights, patterns, and design implications |
| competitive-analysis | Map the competitive landscape and identify gaps and differentiation opportunities |
| stakeholder-summary | Understand who the key stakeholders are, what they need, and how to engage them |
| journey-map | Map the customer journey: stages, touchpoints, emotional curve, pain points, and moments of truth |
| market-sizing | Estimate market opportunity (TAM/SAM/SOM) with multiple frameworks and source-graded confidence |
Define - Frame the problem (5)
| Skill | What it does |
|---|---|
| problem-statement | Crystal-clear problem framing with scope, impact, and success criteria |
| hypothesis | Testable assumptions with measurable success conditions |
| opportunity-tree | Teresa Torres-style outcome-driven opportunity mapping |
| jtbd-canvas | Jobs to be Done framework for understanding customer motivation |
| prioritization-framework | Run RICE, ICE, MoSCoW, Weighted Scoring, and Kano in parallel with a cross-framework comparison |
Develop - Explore solutions (4)
| Skill | What it does |
|---|---|
| solution-brief | One-page solution pitch with tradeoffs and open questions |
| spike-summary | Document technical exploration outcomes and decisions |
| adr | Architecture Decision Records in Michael Nygard format |
| design-rationale | Why you made that design choice, documented for future reference |
Deliver - Ship it (6)
| Skill | What it does |
|---|---|
| prd | Comprehensive product requirements document with problem, metrics, stories, scope, and dependencies |
| user-stories | INVEST-compliant stories with acceptance criteria |
| acceptance-criteria | Given/When/Then testable scenarios |
| edge-cases | Error states, boundaries, and recovery paths |
| launch-checklist | End-to-end launch checklist so nothing gets missed |
| release-notes | User-facing release communication |
Measure - Validate with data (6)
| Skill | What it does |
|---|---|
| experiment-design | Rigorous A/B test planning with hypothesis, sample size, and success criteria |
| instrumentation-spec | Event tracking requirements for engineers |
| dashboard-requirements | Analytics dashboard specifications |
| experiment-results | Document and synthesize learnings from completed experiments |
| okr-grader | Score completed OKR sets at cycle close with KR-level scoring and learning synthesis |
| survey-analysis | Analyze survey results into persona segments, validated hypotheses, and honest limitation warnings |
Iterate - Learn and improve (4)
| Skill | What it does |
|---|---|
| retrospective | Team retros that produce real action items, not just feelings |
| lessons-log | Build organizational memory from repeated patterns and surprises |
| refinement-notes | Capture backlog refinement outcomes and decision rationale |
| pivot-decision | Evidence-based pivot/persevere framework with clear decision criteria |
🔗 More resources:
- Using Skills Guide - Practical guide to invoking skills across different agents, passing context effectively, and getting consistent outputs session to session.
- Using Workflows Guide - How to run multi-skill chains, handle handoffs between skills, and adapt workflows to your team's process.
- Recipes - Curated patterns for common PM scenarios: solo feature launch, quarterly OKR cycle, research-to-delivery arc.
- Prompt Gallery - Real prompts that produce excellent skill outputs, annotated with what makes each one effective.
Tool Family: Foundation Sprint (7)
A Foundation Sprint is a short, structured workshop that clarifies the problem space, target users, success metrics, constraints, and business context before creative exploration begins. It ensures teams start with shared understanding and crisp definitions so downstream design and product decisions move faster and with fewer reversals.
Run the full methodology with the foundation-sprint workflow.
%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#eff6ff', 'primaryBorderColor': '#bfdbfe', 'lineColor': '#3b82f6'}}}%%
flowchart LR
classDef sprint fill:#0284c7,stroke:#0369a1,color:#fff,font-weight:bold
classDef gate fill:#1d4ed8,stroke:#1e40af,color:#fff,font-weight:bold
R["1. Readiness<br/>Go / No-Go check"]:::gate
B["2. Basics<br/>Customer + Problem + Competition"]:::sprint
Di["3. Differentiation<br/>2x2 advantage map"]:::sprint
A["4. Approach Options<br/>3-5 high-level paths"]:::sprint
M["5. Magic Lenses<br/>Score approaches"]:::sprint
H["6. Founding Hypothesis<br/>Synthesize direction"]:::sprint
Br["7. Brief<br/>One-page output"]:::gate
R --> B --> Di --> A --> M --> H --> Br
| Skill | What it does |
|---|---|
| foundation-sprint-readiness | Decision tree for evaluating whether a Foundation Sprint is the right next step |
| foundation-sprint-basics | Establish the customer, problem, and competitive context (the founding 3-tuple) |
| foundation-sprint-differentiation | Map your team's unique advantages on a 2x2 framework |
| foundation-sprint-approach-options | Generate 3-5 high-level strategic approaches |
| foundation-sprint-magic-lenses | Score approaches across 3-4 critical evaluation lenses |
| foundation-sprint-founding-hypothesis | Synthesize the chosen approach into a testable founding hypothesis |
| foundation-sprint-brief | Produce the one-page sprint brief that serves as input for a Design Sprint |
🔗 More resources:
- Foundation Sprint Concept Primer - A Foundation Sprint is a 2-day structured workshop methodology developed by Jake Knapp and John Zeratsky. This primer explains what it is, when to use it, the 7-step sequence, and how it compares to a Design Sprint.
- Using Foundation Sprint - Operational guide for running the 7-skill Foundation Sprint sequence with an agent, including facilitation notes and output expectations for each step.
- Foundation Sprint FAQ - Answers to common questions about the methodology: how long it takes, who should be in the room, what to do with the brief output, and when not to run it.
- Foundation Sprint Cheat Sheet - One-page quick reference for the day-arc, skill sequence, and key outputs.
- Foundation Sprint Case Studies - Three fictional scenarios showing how different teams used the Foundation Sprint methodology at different stages.
- [Foundation Sprint Recovery](https://product-on-purpose.github.io/pm-skills/gui
No comments yet
Be the first to share your take.