Skip to content

product-on-purpose/pm-skills

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

736 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

A curated library of 66 best-practice, plug-and-play product management skills covering the complete product lifecycle - plus templates, workflows, and 95+ real-world sample outputs that set the quality bar.

Report a Bug Β· Request a Feature Β· Ask a Question

Project Status: Active License Version Skills Agent Skills Spec Install via skills.sh PRs Welcome

Stars Forks Open Issues Contributors Last Commit

MCP Server: Maintenance Mode

About β€’ Install β€’ Skills β€’ Sub-Agents β€’ Workflows β€’ Learning β€’ Status β€’ Contributing β€’ Community


Table of Contents

Quick Start

After installing, you'll have all 66 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 95+ 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.

(back to top)


Recent Updates

MCP Server: Maintenance Mode (effective 2026-05-04)

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

v2.27.1 - Maintenance: classification sub-count drift gate

What changed. A maintenance patch with no skill behavior change (catalog stays 66). The count-consistency CI gate now polices the four per-classification / per-phase skill sub-counts (phase, foundation, utility, tool) against their frontmatter source of truth, so a stale "10 utility skills" or "Foundation Skills (9)" fails CI like a stale total - closing the gap that let the classification split drift on a published page until a v2.27.0 hand audit caught it. The change is additive (the total-count check is unchanged); historical point-in-time mentions use word-form numbers or count-exempt ranges. Three stale sub-counts the new gate surfaced are fixed.

Get started. v2.27.1 release notes

v2.27.0 - Provable quality: trigger evals, generated catalog surfaces, eval-ready skill creation

What changed. The provable-quality release - no new skills (catalog stays 66), just the machinery that makes quality verifiable and regression-protected. Trigger-accuracy evals (M-31): every measured skill carries labeled evals/trigger-fixtures.json; a controlled router eval scores per-skill recall/precision against a committed baseline; new CI gates fail on routing drift or a new-skill collision. Derived surfaces (M-32): skill-manifest.json and the AGENTS.md catalog are generated from frontmatter behind enforcing staleness gates, retiring the hand-sync drift class. Output-quality evals (M-33): the harness, six family rubrics, the unit-tested aggregation + verdict module, a three-arm informed control, and the asset-presence gate ship (per-skill results stay internal evidence). The creator/validator family (utility-pm-skill-builder / utility-pm-skill-validate 1.1.0) now bakes the eval contract into skill creation, and the reciprocal-boundary-pointer gate is enforcing.

Get started. v2.27.0 release notes

v2.26.0 - Authoring + quality: /chain ad-hoc runner, workflow builder, 26-skill convergence

What changed. Two new authoring surfaces close the try-then-keep loop. The /chain command runs any ad-hoc ordered skill sequence (/chain deliver-prd -> deliver-user-stories <context>) through the existing pm-workflow-orchestrator engine, checkpointed by default, with the grammar written once as the Mode B Chain Expression Contract; no new engine, no new skill. The new utility-pm-workflow-builder skill (catalog 65 to 66) turns a proven chain or a fresh idea into a staged draft workflow packet (workflow file + command + promotion checklist) for human review. The quality-convergence effort completed: all 26 original-generation skills now carry "When NOT to Use" boundary pointers and enumerated output contracts, with zero instruction rewrites and zero template changes. The orchestrator's native delegation path was live smoke-tested on the installed plugin before tagging (recorded PASS; the procedure is now a repeatable runbook).

Get started. v2.26.0 release notes

v2.25.2 - Maintenance: validator-inventory manifest + parity gate, closes the Codex audit

What changed. A maintenance patch that resolves the remaining 2026-06-06 Codex audit items and hardens the release gate; no new skills (catalog stays 65). Adds a single validator-inventory manifest (scripts/validation-manifest.yaml) and an enforcing CI parity referee (scripts/check-validator-parity.mjs), so the bash, PowerShell, and CI validator inventories can no longer drift; reconciles a live drift it caught (two validators enforcing in CI but missing from both local bundles); extends the root-doc-link checker to source files; promotes the em-dash-scar guard to enforcing (now multi-backtick aware); and corrects the CLAUDE.md "internal notes are gitignored" claim. A Codex adversarial review of the release ran first; its findings were resolved before tagging.

Get started. v2.25.2 release notes

v2.25.1 - Maintenance: docs-site Pattern S, resource index, em-dash-scar cleanup + CI guards

What changed. A maintenance patch that banks accumulated untagged work since v2.25.0; no new skills (catalog stays 65). The documentation site moved to the Product on Purpose family layout (Pattern S) with full family-standard conformance; a generated, CI-gated resource index (docs/RESOURCES.md) now links every published page to its source; root-document links left by the relocation were repaired and an enforcing CI guard added; residual em-dash-sweep . scars were swept to - across user-facing and internal prose, with new advisory and enforcing guards to keep them out; three site dependencies were bumped; and the PowerShell pre-tag validator bundle was reconciled with the bash and CI inventory. No behavior change and no published-URL change.

Get started. v2.25.1 release notes

v2.25.0 - Activation and trust layer: the plugin's first hooks

What changed. Adds the plugin's first hooks plus an advisory output-quality CI tier; no new skills (catalog stays 65). Opt-in house-rule guardrails (F-43): a PreToolUse hook that blocks em-dash and en-dash characters when you enable guardrails: true in .claude/pm-skills.local.md (placeholder and metric checks warn, never block). Confident-only phase router (F-44): a SessionStart hook that, only when a repo signal is strong (a phase-named branch or a recognized artifact), suggests the right Triple Diamond skills for where you are; it stays silent otherwise. Output-quality eval harness (M-30): three deterministic invariant validators over the recorded samples (no placeholders, exact-quote sourcing, no fabricated metrics), wired advisory in CI. The hooks are dependency-free and fail open. Additive minor; nothing existing was removed.

Get started. v2.25.0 release notes

v2.24.0 - Plan orchestrator: run a prioritized action plan end to end

What changed. Ships the pm-workflow-orchestrator sub-agent (the fifth) and its cross-client dispatch skill utility-pm-workflow-orchestrator (utility): a governed runner that takes a saved foundation-prioritized-action-plan (or a user-named chain) and runs an ordered sequence of pm-skills against it, pausing for human go/no-go by default and refusing to advance past a failed or empty step. The plan skill foundation-prioritized-action-plan moves to v1.1.0, gaining an optional --run handoff that offers to run its own runnable prompts through the orchestrator. The catalog grows to 65 skills (utility 10 to 11; foundation unchanged at 9); sub-agents go 4 to 5. The orchestrator ships EXPERIMENTAL on all non-Claude clients, and the native sub-agent-to-skill path ships EXPERIMENTAL until a live smoke test. Additive minor; nothing existing was removed.

Get started. v2.24.0 release notes

v2.23.0 - New skill: prioritized action plan

What changed. One new foundation skill, foundation-prioritized-action-plan, turns any PM input (notes, transcripts, drafts, executive asks, raw situations) into one evidence-grounded prioritized action plan: the critical next effort plus follow-ons, each with why, what, how, confidence, and source. Theory of Constraints ranks by the single binding constraint; Cynefin caps plan confidence (probes for Complex, stabilization for Chaotic). A source ledger is built before analysis and every claim cites an exact input quote, so it refuses High-confidence plans for uncertain situations. The catalog grows to 64 skills; additive minor, nothing existing changed.

Get started. v2.23.0 release notes

v2.22.0 - One menu entry per skill + native Codex support

What changed. Each skill used to appear twice in the / menu (its full name plus a short command wrapper). The 63 wrappers are removed, so each capability now appears once, as the skill. Separately, a native .codex-plugin/plugin.json is added so Codex discovers the skills (it previously reported "No plugin skills"). All 63 skills are unchanged; only the redundant wrapper layer is gone (commands 73 to 10, keeping the 10 /workflow-*). If you saved a short command like /pm-skills:okr-writer, use the skill's full name (/pm-skills:foundation-okr-writer). Shipped as a minor.

Get started. v2.22.0 release notes

v2.21.0 - Marketplace Launch (additive)

What changed. pm-skills is now published through the new product-on-purpose marketplace, a single home for multiple Product on Purpose plugins. This is a distribution change only: your skills, commands, and their behavior are identical (catalog stays 63; 73 commands). The previous install path keeps working, so existing installs need no action; the new marketplace is simply the recommended home going forward. Shipped as a minor because nothing you rely on was removed.

Get started. v2.21.0 release notes

v2.20.0 - Sprint Workflow Commands + Validation Hardening

What changed. The three workshop methodologies are now single slash commands: /workflow-foundation-sprint, /workflow-design-sprint, and /workflow-foundation-to-design chain their per-day sprint skills end-to-end (slash commands 70 to 73; no new skills, catalog stays 63). Under the hood the gate got stricter: the command-sync validator now requires every advertised /workflow- command to have a real file, and the count-consistency validator now catches stale counts in table, parenthetical, and "N command files" phrasings (not just "N commands") - which surfaced and fixed count drift across several reference docs. The near-vestigial bundle-terminology validator was removed.

Get started. v2.20.0 release notes

v2.19.0 - Pre-Promotion Hardening

What changed. Nothing you use behaves differently - no new skills, no changed commands, the catalog stays at 63. What improved is trust. The library's automated checks now catch the defect classes that slipped past CI in v2.18.0 and previously needed a human to spot: stale counts on the docs site, references to skills that do not exist, and dead internal links. Under the hood that means a new cross-reference validator, .mdx count scanning, same-page anchor validation (23 pre-existing breaks fixed), an enforced version badge, pinned line endings, an honestly-scoped local validator bundle, and a branded 404 page. This is the hardening pass before pm-skills is actively promoted, so anyone adopting it can rely on the catalog staying internally consistent.

Get started. v2.19.0 release notes

v2.18.0 - Highest-Consensus PM Skill Gaps

What changed. Four new phase skills close the highest-consensus PM gaps: market-sizing (TAM/SAM/SOM via multi-framework triangulation), prioritization-framework (RICE, ICE, MoSCoW, Weighted Scoring, and Kano run in parallel with a cross-framework comparison), journey-map (stages, touchpoints, emotional curve, and moments of truth), and survey-analysis (honest analysis with explicit limitation warnings). The catalog grows from 59 to 63 skills; each new skill refuses to fabricate data and labels confidence honestly.

Get started. v2.18.0 release notes

v2.17.0 - Native Sub-Agent Registration

What changed. The 4 sub-agents now register natively on Claude Code: their definitions moved to the canonical agents/ directory, so @pm-critic (and the other three) auto-discover and dispatch via @-mention. To free the agents/ name on case-insensitive filesystems, the agent-coordination directory was renamed from AGENTS/ to _agent-context/. Skill frontmatter also migrated to the metadata-nested structure per the agentskills.io spec, and the CI validators are now bash-3.2 portable. The 59-skill catalog is unchanged; cross-client clients keep working via the dispatch skills.

Get started. v2.17.0 release notes

v2.16.2 - Release Hygiene and GitHub Release Body Update

What changed. Post-tag plan SHIPPED state updates and GitHub Release body corrections following the v2.16.1 patch cycle.

Get started. v2.16.2 release notes

v2.16.1 - Plugin Manifest Fix

What changed. Removed the invalid agents field from plugin.json that was causing /plugin update pm-skills to fail with an "Invalid input" error since v2.16.0. If you ran into that error, update to this version.

Get started. v2.16.1 release notes

v2.16.0 - Active Orchestration with Sub-Agents

What changed. First 4 active-orchestration sub-agents shipped (pm-critic, pm-skill-auditor, pm-changelog-curator, pm-release-conductor), giving Claude Code a stable interface for spawning sub-tasks against the catalog. 4 dispatch skills extend sub-agent-shaped flows to Codex, Cursor, Windsurf, Copilot, and Gemini CLI. The 6-gate pre-tag release runbook is now written down.

Why it matters. Foundation work for chained workflows that don't need a human in the handoff loop.

Get started. Runtime components - v2.16.0 release notes

v2.15.0 - Sprint Skills Launch

What changed. 15 new skills under a new classification: tool taxonomy. Foundation Sprint family (Knapp/Zeratsky 2-day workshop methodology) + Design Sprint family (Knapp/Zeratsky/Kowitz 5-day workshop methodology) + standalone note-and-vote. Catalog grows from 40 to 55. New foundation-to-design workflow chains both end-to-end.

Why it matters. If you run structured workshop sessions, the agent runs the workshop with you using canonical moves; outputs are workshop artifacts.

Get started. Foundation sprint - Design sprint - v2.15.0 release notes

v2.14.x - Doc Stack Migration to Astro Starlight

What changed. Retired MkDocs Material; migrated to Astro Starlight. Pagefind full-text search, native dark mode, Node 22.x build. v2.14.1 added the Mermaid style guide; v2.14.2 closed a cumulative docs hygiene patch.

Why it matters. Search works (full-text, instant). Forkers: Node 22.x is now required, not Python pip.

Get started. product-on-purpose.github.io/pm-skills - v2.14.0 release notes

v2.13.x - Plugin Install Path Correction

What changed. Fixed /plugin marketplace add install. Moved marketplace.json to .claude-plugin/; added the required owner schema field; introduced an enforcing validate-plugin-install CI script.

Why it matters. Before v2.13.1, the marketplace install failed silently. After v2.13.1, it is the recommended Claude Code path.

Get started. v2.13.1 release notes

v2.12.0 - OKR Skills

What changed. OKR-focused skill set: okr-writer (foundation) and okr-grader (measure), plus the operational pattern for using them across a quarter.

Why it matters. OKR structure, KR quality bar, and grading rubric are encoded as skills your agent runs consistently across cycles.

Get started. v2.12.0 release notes

(back to top)


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

  • βœ… 66 Production-Ready Skills covering the complete product lifecycle (30 phase skills + 9 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
Loading

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

Agent Skills Spec GitHub Flavored Markdown GitHub Actions

(back to top)


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 66 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 66 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.

(back to top)


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
Loading
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.

(back to top)


The Skill Library

Phase Skills: 30 Foundation Skills: 9 Tool Family Skills: 15 Utility Skills: 12

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 (21 skills)"]
        direction LR
        FOUND["Foundation<br/>9 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
Loading
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) 9 Persona, lean canvas, OKRs, prioritized action plan, 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 (9)

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

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.

(back to top)


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
Loading
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 - What to do when a sprint produces a confusing founding hypothesis, the team disagrees on direction, or you want to redo a step.

(back to top)


Tool Family: Design Sprint (7)

A Design Sprint is a fast, structured process that helps teams understand a problem, explore solutions, build a prototype, and test it with real users in five days. It reduces risk by forcing alignment and validation before any heavy engineering investment.

Run the full methodology with the design-sprint workflow. Chain it after a Foundation Sprint with foundation-to-design.

%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#fdf4ff', 'primaryBorderColor': '#e9d5ff', 'lineColor': '#9333ea'}}}%%
flowchart LR
    classDef sprint fill:#7c3aed,stroke:#6d28d9,color:#fff
    classDef gate fill:#581c87,stroke:#3b0764,color:#fff,font-weight:bold
    classDef day fill:#6d28d9,stroke:#5b21b6,color:#fff

    R["Readiness<br/>Go / No-Go"]:::gate
    Br["Brief<br/>Goal + Questions"]:::sprint
    M["Day 1<br/>Map and Target"]:::day
    S["Day 2<br/>Sketch"]:::day
    D["Day 3<br/>Decide and Storyboard"]:::day
    P["Day 4<br/>Prototype Plan"]:::day
    T["Day 5<br/>Test and Score"]:::gate

    R --> Br --> M --> S --> D --> P --> T
Loading
Skill What it does
design-sprint-readiness Decision tree for evaluating whether a Design Sprint is the right next step
design-sprint-brief Pre-sprint brief: long-term goal and sprint questions
design-sprint-map-and-target Customer journey map and chosen target moment
design-sprint-sketch Structured 4-step individual sketch session
design-sprint-decide-and-storyboard Heat map, straw poll, decider vote, and storyboard
design-sprint-prototype-plan Realistic-enough Friday prototype plan
design-sprint-test-and-score 5 customer interviews, scored patterns, and decision

πŸ”— More resources:

  • Design Sprint Concept Primer - A Design Sprint is a 5-day structured workshop methodology developed at Google Ventures by Jake Knapp, John Zeratsky, and Braden Kowitz. This primer covers the methodology's heritage, the 5-day arc as implemented in this skill family, and how it differs from a physical in-person workshop.
  • Using Design Sprint - Operational guide for running the 7-skill Design Sprint sequence with an agent, including what "realistic-enough" means for the prototype step and how to recruit for test day.
  • Design Sprint FAQ - Questions about prototype fidelity, user recruitment, scoring results, and what to do if no clear winner emerges after testing.
  • Design Sprint Cheat Sheet - One-page quick reference for the 5-day arc, skill sequence, and key outputs.
  • Design Sprint Case Studies - Fictional scenarios applying the Design Sprint to B2C, B2B, and internal-tools product challenges.
  • Design Sprint Recovery - What to do when prototype testing produces inconclusive results, the test fails entirely, or the team needs to iterate on the storyboard.
  • Workshop Sprints vs Agile Sprints - The disambiguation every Scrum team needs before running their first Design Sprint. Two completely different processes, one unfortunately shared word.
  • Workshop Method Comparison - When to use Foundation Sprint vs Design Sprint vs other structured workshop approaches; includes a decision matrix.

(back to top)


Standalone Tool Skill

Skill What it does
note-and-vote Group decision mechanic usable inside any workshop or meeting - silent capture, share aloud, dot vote, discuss top-voted only, decider calls it

Utility Skills - Meta-tooling (12)

Skill What it does
pm-skill-builder Create new PM skills with gap analysis, classification, and guided drafting
pm-skill-validate Audit a skill against structural conventions and quality criteria
pm-skill-iterate Apply targeted improvements from feedback or validation reports
pm-workflow-builder Author a new multi-skill workflow (or promote a proven /chain) into a staged draft packet for review
mermaid-diagrams Create syntactically valid mermaid diagrams for product documents
slideshow-creator Generate professional presentations from JSON deck specifications
update-pm-skills Check for and apply updates to a local PM-Skills installation
pm-critic Adversarial quality reviewer for PM artifacts - also available as a sub-agent in Claude Code
pm-skill-auditor Cross-skill catalog auditor against structural and quality criteria - also available as a sub-agent
pm-changelog-curator CHANGELOG manager and entry drafter following conventional commit rules - also available as a sub-agent
pm-release-conductor Release orchestrator walking the 6-gate pre-tag runbook - also available as a sub-agent
pm-workflow-orchestrator Governed multi-skill runner; walks an ordered plan/chain with per-step go/no-go - also available as a sub-agent


Sub-Agents

Sub-agents are specialist agents that Claude Code can spawn as autonomous sub-tasks within a larger session. Unlike skills - which are instruction files your agent reads inline - a sub-agent is a separate agent instance launched for a focused job. It runs against the skills catalog, produces its output, and returns the result to the orchestrating session. The orchestrator continues with that output as context.

%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#f8fafc', 'primaryBorderColor': '#cbd5e1', 'lineColor': '#64748b', 'clusterBkg': '#f1f5f9', 'clusterBorder': '#cbd5e1'}}}%%
flowchart LR
    classDef orchestrator fill:#1e293b,stroke:#0f172a,color:#f8fafc,font-weight:bold
    classDef subagent fill:#4f46e5,stroke:#3730a3,color:#fff,font-weight:bold
    classDef catalog fill:#7c3aed,stroke:#5b21b6,color:#fff
    classDef output fill:#166534,stroke:#14532d,color:#fff,font-weight:bold

    O["Your Claude Code session<br/>(orchestrator)"]:::orchestrator
    subgraph SA["Sub-Agent (spawned instance)"]
        direction LR
        Agent["Specialist agent"]:::subagent
        Cat["Skills catalog"]:::catalog
        Agent -- reads --> Cat
    end
    Out["Focused output<br/>returned to session"]:::output

    O -- "spawns" --> SA
    SA --> Out
    Out -- "informs" --> O
Loading

For other platforms (Codex, Cursor, Windsurf, Copilot, Gemini CLI), each sub-agent ships as a paired utility skill with dispatch instructions that replicate the same workflow in standard skill invocation mode.

Sub-Agent Command What it does
pm-critic /pm-skills:utility-pm-critic Adversarial quality reviewer. Reads a PM artifact and produces a severity-graded findings report covering gaps, weak assumptions, and missing sections. Use it to stress-test a PRD, hypothesis, or opportunity tree before sharing with stakeholders.
pm-skill-auditor /pm-skills:utility-pm-skill-auditor Cross-skill catalog auditor. Checks a skill against structural conventions, frontmatter requirements, and quality criteria. Use it before contributing a new skill or after making changes to an existing one.
pm-changelog-curator /pm-skills:utility-pm-changelog-curator CHANGELOG manager. Drafts and formats changelog entries from git history and release context, following conventional commit classification rules and the repo's established CHANGELOG format.
pm-release-conductor /pm-skills:utility-pm-release-conductor Release orchestrator. Walks through the 6-gate pre-tag release runbook: pre-tag readiness, adversarial review, version bumps, tagging, artifact verification, and post-tag hygiene.
pm-workflow-orchestrator /pm-skills:utility-pm-workflow-orchestrator Governed multi-skill runner. Walks an ordered step list (a saved foundation-prioritized-action-plan or a user-named chain), pausing for human go/no-go and refusing to advance past a failed or empty step. Ships EXPERIMENTAL.

πŸ”— More resources:

  • Active Orchestration Guide - What sub-agents are, how Claude Code spawns them, the dispatch skill pattern for other platforms, and invocation examples for all five sub-agents.
  • v2.16.0 Release Notes - The release that introduced active orchestration, including the rationale for the sub-agent model and how it connects to the broader skill ecosystem.

(back to top)


Workflows (skill chaining)

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 so context flows naturally from discovery through delivery.

Workflow Best for Skills included
Foundation to Design End-to-end strategic alignment into prototype-and-test foundation-sprint-* + design-sprint-*
Foundation Sprint 2-day strategic alignment only All 7 foundation-sprint skills
Design Sprint 5-day prototype-and-test only All 7 design-sprint skills
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 30 phase-skill flow across 6 phases
Customer Discovery Research synthesis Raw research into a validated problem statement
Sprint Planning Sprint prep Sprint-ready stories from a backlog

Ad-hoc chains and building your own. When no curated workflow fits, /chain runs any ordered sequence of skills against shared context (ephemeral, checkpointed by default; it routes to the pm-workflow-orchestrator engine). If a chain proves reusable, utility-pm-workflow-builder guides you from that chain (or a fresh idea) to a complete draft workflow packet, staged for review before anything lands in the repo.

(back to top)


Library Examples

Why Examples Matter More Than You Think

When you ask an AI to write a PRD, the output quality is anchored to its training data average. That average is mediocre. The examples in this library are the floor, not the ceiling. They are the quality signal your agent calibrates against before writing anything.

There are two layers of examples:

  1. Skill-level EXAMPLE.md - every skill ships with a worked example sitting right next to the SKILL.md. This is what the agent reads at the moment it runs the skill.
  2. Library samples (library/skill-output-samples/) - 95+ full outputs across three narrative threads. These are for you, not just the agent: read them before a skill run to calibrate expectations, or browse them to understand what a skill you haven't used actually produces.

Varied Prompt Maturity to Reflect Reality

The samples in this library intentionally vary in how polished the prompts are... Some use carefully structured, multi-turn context; others are more direct single invocations. This was a deliberate choice for two reasons:

  • To reflect real life. The AI tooling landscape is evolving fast. Product managers are figuring out what works in real time. A library full of "perfect" prompts would misrepresent how most people actually work with AI today.
  • To lower the bar for experimentation. The goal of this library is to encourage you to try, not to intimidate you with a gallery of polished outputs. If a sample was produced with a rough prompt and still looks good, that's a feature - it means the skill is doing the heavy lifting.

You'll find a natural range across the samples:

  • Direct invocations with minimal context (most Brainshelf samples, early-stage framing)
  • Single-turn invocations with a short briefing paragraph (most Storevine samples)
  • Multi-step structured invocations with full context blocks (most Workbench ADR and stakeholder samples)

Browse the library to find the level of maturity that matches your current practice - then experiment upward from there.

Three Narrative Threads Across Three Fictional Companies

The library isn't a random collection of samples. It's organized around three fictional companies that each operate at a different stage, in a different industry, with different PM challenges. Every sample belongs to one of these threads so you can follow a company's product story across multiple skills.

Brainshelf - Early-Stage B2C Founder

  • The company: Brainshelf builds a personal knowledge product - a tool for people who capture notes, articles, and ideas across too many apps and an never find them later. Think early-stage B2C, one PM who is also the founder, zero product-market fit certainty.
  • Why this thread exists: Early-stage PM work looks different. Hypotheses are looser. Personas aren't validated by a research team. Foundation Sprints and lean canvases matter more than full PRDs. The Brainshelf samples show how to use PM skills when you have more questions than answers.
  • Best samples to start with: define-hypothesis, tool-foundation-sprint-basics, discover-interview-synthesis, tool-foundation-sprint-founding-hypothesis

Storevine - Mid-Stage E-Commerce PM

  • The company: Storevine is a mid-market e-commerce SaaS platform. The PM running the checkout-conversion program is three years into the role, works with an engineering team of six, and is accountable to experiment velocity and revenue-per-visit metrics.
  • Why this thread exists: Most PM skill work happens in the middle: running experiments, measuring results, writing PRDs for known problems, aligning stakeholders on tradeoffs. The Storevine samples represent the bread-and-butter PM output at a company with enough scale to run rigorous tests but without so much bureaucracy that every artifact becomes a political battle.
  • Best samples to start with: deliver-prd, measure-experiment-design, measure-okr-grader, define-opportunity-tree

Workbench - Internal-Tools PM at a Growing Org

  • The company: Workbench is the internal tooling and platform team at a 200-person organization moving from startup to scale. The PM's "users" are internal employees and the "product" is the internal tooling layer - blueprints, automation, integrations.
  • Why this thread exists: Internal-tools PM is its own discipline. Stakeholders are your co-workers. The cost of ignoring feedback is high because users are captive. ADRs matter more than press releases. Stakeholder updates go to department heads who have opinions. This thread shows PM skills applied to the least-glamorous-but-often-most-impactful area of product work.
  • Best samples to start with: develop-adr, foundation-stakeholder-update, foundation-meeting-recap, iterate-retrospective

Browse the Library

Since product management is all about context, there are several ways for you to review the skills and outputs.

  1. By skill - organized by skill name: library/skill-output-samples/
  2. By company thread - follow one company's story across multiple skills:
Thread Folder pattern Starting point
Brainshelf *_brainshelf_* define-hypothesis resurface
Storevine *_storevine_* deliver-prd campaigns
Workbench *_workbench_* develop-adr blueprints
  1. By scenario - the "resurface" feature (Brainshelf), "campaigns" program (Storevine), and "blueprints" initiative (Workbench) recur across dozens of skills, so you can see how outputs connect and build on each other.

More resources:

  • Skill Output Samples - All 95+ sample outputs organized by skill name. Browse to calibrate expectations before running a skill.
  • Prompt Gallery - The prompts that generated many of the best library samples, annotated with what makes each one effective. A useful companion when you want to improve your own invocation patterns.

(back to top)


Learning and Resources

PM-Skills isn't just a skill repo. It ships with a full learning layer:

  • Concept primers
  • How-to guides
  • Cheat sheets
  • Case studies
  • Recovery playbooks
  • A prompt gallery
  • ... and 95+ real sample outputs.

Learn the Methodologies

These guides explain the why behind the workshop frameworks and PM practices this library encodes:

  • Foundation Sprint concept primer - A Foundation Sprint is a structured 2-day workshop methodology developed by Jake Knapp and John Zeratsky for aligning early-stage teams before design begins. This primer explains what it is, when to run one, how the 7 skills fit together, and how it relates to the Design Sprint.
  • Design Sprint concept primer - A Design Sprint is a structured 5-day process for understanding a problem, sketching solutions, building a prototype, and testing with real users. This primer covers the Google Ventures heritage, the 5-day arc as implemented in this skill family, and how it differs from running a physical workshop.
  • Sprint skills overview - An orientation to both workshop tool families: how Foundation Sprint and Design Sprint relate to each other, to the Triple Diamond framework, and to the rest of the PM-Skills catalog. Start here if you are new to either methodology.
  • Workshop sprints vs agile sprints - If your team runs Scrum or any other agile framework, read this before running either workshop methodology. The word "sprint" means two completely different things in these two contexts, and confusing them is the most common source of friction for new users.

Use Skills Effectively

  • Using skills guide - Foundational guide to invoking skills across different agents, passing context effectively, and getting consistent outputs. Covers invocation patterns, context blocks, and how to recover from incomplete outputs.
  • Using workflows - How to run multi-skill chains, handle handoffs between skills so context flows correctly, and adapt workflow sequences to your team's specific process.
  • Skill finder - Decision guide for finding the right skill when you know the outcome you need but not which skill to reach for. Organized by PM activity and phase.
  • Skill comparisons - Side-by-side comparison of skills with overlapping scope: when to use problem-statement vs hypothesis vs opportunity-tree, and similar questions that come up repeatedly.
  • Recipes - Common patterns and skill combinations for real PM scenarios: solo feature launch, quarterly OKR cycle, research-to-delivery arc, and more.
  • Prompt gallery - Real prompts that produce excellent skill outputs, annotated with what makes each one work. A practical reference for getting better results immediately.

Foundation Sprint Resources

The Foundation Sprint tool family ships with five companion guides covering every stage of use:

  • Using Foundation Sprint - Operational guide for running the complete 7-skill Foundation Sprint sequence with an agent. Covers facilitation patterns, what to do between steps, and output quality expectations for each skill.
  • Foundation Sprint FAQ - Answers to the most common questions about the Foundation Sprint workshop methodology: who should be in the room, how long each step takes, what the founding hypothesis output looks like, and what to do with the brief.
  • Foundation Sprint Cheat Sheet - One-page quick reference for the Foundation Sprint arc: skill sequence, key questions, and outputs. Print it or keep it open during a session.
  • Foundation Sprint Case Studies - Three fictional scenarios (early-stage B2C, mid-market SaaS, internal tools) showing how different teams applied the Foundation Sprint at different stages and under different constraints.
  • Foundation Sprint Recovery - What to do when a sprint goes sideways: confusing founding hypothesis, team disagreement on direction, a step that needs to be redone, or a situation where the readiness check was wrong.

Design Sprint Resources

The Design Sprint tool family ships with five companion guides:

  • Using Design Sprint - Operational guide for running the 7-skill Design Sprint sequence with an agent. Covers what "realistic-enough" means for the prototype step, how to structure test-day interview sessions, and how to score results.
  • Design Sprint FAQ - Questions about prototype fidelity, participant recruitment for test day, scoring criteria, and what to do when no clear winner emerges from testing.
  • Design Sprint Cheat Sheet - One-page quick reference for the 5-day arc: skill sequence, daily outputs, and decision points.
  • Design Sprint Case Studies - Fictional scenarios applying the Design Sprint to B2C product discovery, B2B feature validation, and an internal-tools redesign challenge.
  • Design Sprint Recovery - What to do when prototype testing is inconclusive, the test fails entirely, the team wants to revisit the storyboard, or time constraints force adjustments.

Reference

  • PM skill anatomy - The three-file structure every skill follows (SKILL.md, TEMPLATE.md, EXAMPLE.md) and what each file contributes to output quality. Essential before authoring a new skill.
  • Agent skill anatomy - The general Agent Skills Specification anatomy that PM-Skills is built on. Useful context for understanding how skills work across the broader AI ecosystem.
  • Mermaid style guide - Using the mermaid-diagrams skill to create consistent, on-brand diagrams. Includes the color palette, classDef patterns, and guidance on when to use LR vs TD layout.
  • Sprint methodology glossary - Definitions for terms used across Foundation Sprint and Design Sprint skills. A useful reference when the meaning of a skill output or workshop term isn't clear.
  • Workshop method comparison - Decision matrix for when to use Foundation Sprint vs Design Sprint vs other structured workshop approaches.
  • Ecosystem overview - How pm-skills, pm-skills-mcp, and the skills CLI relate to each other; which to use for which client and workflow.

(back to top)


Project Status

At a Glance

Current version v2.27.1
Skill count 66 skills (30 phase + 9 foundation + 12 utility + 15 tool)
Sub-agents 5 (pm-critic, pm-skill-auditor, pm-changelog-curator, pm-release-conductor, pm-workflow-orchestrator)
Workflows 12
Slash commands 11
Spec agentskills.io
License Apache 2.0
Docs site product-on-purpose.github.io/pm-skills

Repo Structure

pm-skills/
β”œβ”€β”€ skills/                  # 66 PM skills (30 phase, 9 foundation, 12 utility, 15 tool)
β”œβ”€β”€ commands/                # Slash commands mapping to skills, workflows, and sub-agents
β”œβ”€β”€ _workflows/              # Workflow chains: feature-kickoff, lean-startup, triple-diamond, and more
β”œβ”€β”€ agents/                  # Sub-agent definitions (v2.16.0+, Claude Code plugin runtime)
β”œβ”€β”€ hooks/                   # Claude Code hooks: house-rule guardrails + phase router (v2.25.0+)
β”œβ”€β”€ library/                 # Sample output library (95+ real skill outputs)
β”œβ”€β”€ scripts/                 # sync-claude, build-release, validate-commands, and CI scripts
β”œβ”€β”€ .github/                 # CI workflows and automation
β”œβ”€β”€ site/                    # Astro docs site, published to product-on-purpose.github.io/pm-skills
β”‚   └── src/content/docs/    # getting-started, concepts, guides, reference, releases
β”œβ”€β”€ docs/
β”‚   └── templates/           # Canonical skill template (copy to author a new skill)
β”œβ”€β”€ AGENTS.md                # Universal agent discovery file
β”œβ”€β”€ CONTRIBUTING.md          # Contribution guidelines
└── CHANGELOG.md             # Version history

Key paths:

Path What's in it
skills/ All 66 PM skills, each with SKILL.md + references/TEMPLATE.md + references/EXAMPLE.md
commands/ Slash command definitions for Claude Code
_workflows/ Multi-skill workflow chains with handoff guidance
library/skill-output-samples/ 95+ real sample outputs organized by skill name
site/src/content/docs/guides/ How-to guides and operational references
site/src/content/docs/concepts/ Methodology primers and conceptual explanations
site/src/content/docs/reference/ Technical reference: skill anatomy, ecosystem, runtime components
docs/RESOURCES.md Browsable index of every resource, linking each live page to its repo source

See project structure reference for detailed descriptions of every directory.

Changelog

See CHANGELOG.md for full details.

Quick Release History
Version Highlights
2.21.0 Marketplace launch (additive): pm-skills is now published through the new product-on-purpose marketplace, the recommended home for multiple Product on Purpose plugins. Distribution change only - the skill catalog (63) and commands (73) are unchanged, and the existing install path keeps working, so no existing user has to act. Shipped as a minor because nothing was removed; the eventual old-path retirement is reserved for a future major.
2.20.0 Sprint workflow commands + validation hardening: the 3 workshop methodologies (Foundation Sprint, Design Sprint, Foundation-to-Design) are now runnable as single /workflow- commands (slash commands 70 to 73). The count-consistency validator now catches stale counts in any phrasing (table, parenthetical, count-noun), and the command-sync validator requires every advertised /workflow- command to have a real file; the vestigial check-stale-bundle-refs validator was removed. No new skills; catalog stays 63.
2.19.0 Pre-promotion hardening: the release-validation gate now polices the library itself, automatically catching the v2.18.0 defect classes - stale counts (.mdx now scanned), broken skill cross-references (new validator), and dead in-page anchors (23 fixed). Enforces the README current-version claim, pins line endings via .gitattributes, removes the vestigial validate-mcp-sync workflow, and ships a branded docs-site 404. No new skills; catalog stays 63.
2.18.0 Four highest-consensus content skills: market-sizing (TAM/SAM/SOM via multi-framework triangulation), prioritization-framework (RICE, ICE, MoSCoW, Weighted Scoring, Kano run in parallel with a cross-framework comparison), journey-map (touchpoints, emotional curve, moments of truth), and survey-analysis (honest analysis with explicit limitation warnings). Catalog grows from 59 to 63 skills; each new skill refuses to fabricate data and labels confidence honestly.
2.17.0 Native Claude Code sub-agent registration: sub-agent definitions moved to the canonical agents/ directory (coordination directory renamed AGENTS/ to _agent-context/), so all 4 sub-agents auto-discover via @-mention. Skill frontmatter migrated to the metadata-nested agentskills.io structure; CI validators made bash-3.2 portable. 59-skill catalog unchanged.
2.16.2 Post-tag hygiene: plan documents updated to SHIPPED state and the GitHub Release body corrected after the v2.16.1 patch cycle. Keeps planning artifacts and the public Release UI synchronized.
2.16.1 Removed the invalid agents field from plugin.json that blocked /plugin update pm-skills with an "Invalid input" error since v2.16.0. If you saw that error after updating, this patch resolves it.
2.16.0 First 4 active-orchestration sub-agents (pm-critic, pm-skill-auditor, pm-changelog-curator, pm-release-conductor) ship with 4 dispatch skills that extend sub-agent workflows to Codex, Cursor, Windsurf, Copilot, and Gemini CLI. Foundation work for chained PM workflows that run without manual handoffs between steps.
2.15.2 Corrected skill counts in release documentation and the README after v2.15.0 shipped with stale aggregate numbers. No skill file changes.
2.15.0 15 new skills under a new classification: tool taxonomy: Foundation Sprint family (7 skills, 2-day strategic alignment), Design Sprint family (7 skills, 5-day prototype-and-test), and standalone note-and-vote. Catalog grows from 40 to 55. A new foundation-to-design workflow chains both methodologies end-to-end.
2.14.2 Cumulative docs hygiene patch closing Codex adversarial review findings: expanded validator scope to .mdx, refreshed the MCP sync guide, hardened sync workflow dispatch inputs, and reframed v2.14.0 deferrals in release notes.
2.14.1 Added the Mermaid style guide and expanded validate-docs-frontmatter scope to .mdx files, closing a validator gap that had allowed frontmatter defects in Astro-specific files to pass CI undetected.
2.14.0 Retired MkDocs Material and migrated to Astro Starlight. Full-text search via Pagefind, native dark mode, Node 22.x build. The docs site is the primary reference going forward; Python pip is no longer required to build it.
2.13.1 Fixed the silent failure in /plugin marketplace add: moved marketplace.json to .claude-plugin/, added the required owner schema field, and introduced an enforcing validate-plugin-install CI script. This is the version that made the marketplace install path reliable and recommended.
2.13.0 Plugin path groundwork: initial schema field investigation and CI script scaffolding ahead of the v2.13.1 fix.
2.12.0 OKR skill pair: okr-writer drafts objectives-and-key-results plans with tight, measurable key results; okr-grader scores completed OKR sets at cycle close with KR-level scoring and learning synthesis. OKR structure and grading rubric are now encoded skills your agent runs consistently.
2.11.0 Meeting Skills Family: 5 foundation-meeting skills (agenda, brief, recap, synthesize, stakeholder-update), a shared family contract, an enforcing CI validator, an end-user guide, and 15 library samples across all three narrative threads. Established the skill family pattern used by later tool families.
2.10.0 Utility skill expansion: mermaid-diagrams (15 diagram types with PM use-case guidance), slideshow-creator (18 slide types from a JSON deck spec), and update-pm-skills (in-place updater with status, preview, and apply modes), each with its slash command.
2.9.0 Renamed "bundles" to "workflows", expanded from 3 to 9 workflow chains, added 7 workflow slash commands, and added URL redirects from old bundle paths. Established workflows as first-class artifacts alongside skills.
2.8.x Docs site launch via MkDocs Material (v2.8.1) and the PM skill lifecycle skills: pm-skill-validate and pm-skill-iterate with lifecycle guide and skill versioning governance (v2.8.0).
2.7.0 First utility skill (pm-skill-builder), the acceptance-criteria phase skill, enhanced CI scripts, and release packaging hygiene.
2.6.x Claude plugin packaging release with staged manifest version checks (v2.6.0); sample-library recovery and naming/path normalization (v2.6.1).
2.5.0 Persona skill shipment establishing the foundation/utility taxonomy separation. Sample-library quality closure pass.
2.4.0 Output and configuration contract lock closure. Established the canonical output format contracts that phase skills follow.
2.3.0 MCP alignment closure and blocking-default sync guardrail. Established the MCP sync observe-mode pattern.
2.2.0 MCP drift guardrail in observe mode. Planning and backlog governance conventions formalized.
2.0.0 Major structural reset: flat skills/{phase-skill}/ directory layout, sync helper scripts, build scripts, and docs refresh. Established the layout convention the repo uses today.
1.2.0 Security policy, CodeQL scanning, Dependabot configuration, and issue/PR templates.
1.1.0 Documentation overhaul: README redesign, FAQ section, and collapsible table of contents.
1.0.0 First stable Triple Diamond baseline: 24 PM skills across 6 phases, workflows, and AGENTS.md for agent discovery. The canonical starting point the rest of the repo builds from.
0.1.0 Initial project structure and foundation infrastructure.

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.

(back to top)


Contributing

Contributions are what make the open-source community such a meaningful place to learn, create, and improve. Any contributions you make are greatly appreciated.

Quick contribution steps:

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

Please read CONTRIBUTING.md for detailed guidelines on:

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

Resources:

(back to top)


Community

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

πŸ’‘ Feature Ideas

🐞 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

πŸ“£ 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

(back to top)


FAQ

What's the difference between Foundation Sprint and Design Sprint?

Foundation Sprint is a 2-day strategic alignment workshop. It answers: "Do we know our problem, customer, and direction well enough to start designing?" Output: a founding hypothesis and a sprint brief.

Design Sprint is a 5-day prototype-and-test workshop. It answers: "Is this particular solution right for this particular problem?" Output: a prototype and test results.

Run a Foundation Sprint first if you don't have strong conviction on the problem space. Run a Design Sprint when you have the problem defined and need to validate a solution approach. Neither of these is an agile iteration sprint.

See Foundation Sprint vs Design Sprint and Workshop Sprints vs Agile Sprints for detailed comparisons.

Do I need to install all 66 skills?

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

Can I use PM-Skills with ChatGPT?

Yes, with some limitations. Copy the contents of any SKILL.md file into your ChatGPT conversation as context and ask it to follow the skill instructions. ChatGPT doesn't support the Agent Skills Specification natively, so you won't get automatic skill discovery or slash commands. For the best experience, use Claude Code, GitHub Copilot, Cursor, or Windsurf.

How do I customize a skill for my team?

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.

What's the difference between skills and workflows?

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.

What's the difference between skills and sub-agents?

Skills are instruction files (SKILL.md + TEMPLATE.md + EXAMPLE.md) that your agent reads inline when you invoke a slash command. The agent doing the work IS your current session.

Sub-agents are separate agent instances that Claude Code spawns as sub-tasks. When you invoke a sub-agent, a new agent context is launched for that specific job, runs against the skills catalog, returns its output to your session, and exits. This separation is useful for tasks that benefit from a clean context - like adversarial review, where the same session that wrote the artifact might not be the best critic.

Sub-agents are currently Claude Code-only. For other platforms, the same four capabilities ship as paired utility skills you invoke like any other skill.

How do I stay up to date with new skills?

Watch the GitHub Releases page for new versions, or use the /pm-skills:utility-update-pm-skills slash command from within your agent to check for and apply updates. Major releases are summarized in the Recent Updates section above.

Why doesn't PM-Skills work with the openskills CLI?

The openskills CLI discovers skills in .claude/skills/ directories. PM-Skills ships a flat skills/{phase-skill}/ structure plus a sync helper. Clone the repo and run ./scripts/sync-claude.sh (or .ps1) to populate .claude/skills/ locally, and openskills or Claude Code discovery will find all skills.

Can I contribute new skills?

Yes. Read the authoring guide for the full process. Submit a proposal via GitHub issue first, then create your skill following the template structure. All contributions are reviewed for quality and alignment with PM best practices.

How do slash commands work in Claude Code?

Slash commands (like /pm-skills:deliver-prd or /pm-skills:define-hypothesis) are shortcuts that invoke the corresponding skill. When you type /pm-skills:deliver-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 after install; the commands are defined in the commands/ directory.

What's the difference between pm-skills and pm-skills-mcp?

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

pm-skills-mcp wraps the same skills in an MCP server for programmatic access. Best for Claude Desktop, Cursor, and any MCP-compatible client when you want tool-based invocation rather than slash commands.

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

(back to top)


About the Author

Created by Jonathan Prisant

Howdy, I'm Jonathan Prisant, a product leader/manager/nerd in the church technology space who gets unreasonably excited about understanding and 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 am a follower of Jesus Christ, grateful husband, proud (and exhausted) daddy, D&D geek, 3D printing enthusiast, formerly-consistent strength trainer, smart home enthusiast, insatiable learner, compulsive tech-experimenter, and a bunch of other things. I have too many projects going on across too many domains - 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.

(back to top)


Built with purpose by Product on Purpose
Helping teams ship better products with AI-powered PM workflows

(back to top)

About

66 plug-and-play, best-practice, product management skills for AI agents: 30 Triple Diamond phase + 8 foundation + 10 utility + 15 tool (Foundation Sprint + Design Sprint)... Plus 4 sub-agents, templates, workflows, samples, learning resources & guides, CI-enforced contracts. Apache 2.0.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Contributors