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

Download Latest Release

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-statement when opportunity-tree is 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