Product Manager Skills

GitHub stars

╔════════════════════════════════════════════════════════════════════╗
║                                                                    ║
║   ██████╗ ███╗   ███╗    ███████╗██╗  ██╗██╗██╗     ██╗     ███████╗
║   ██╔══██╗████╗ ████║    ██╔════╝██║ ██╔╝██║██║     ██║     ██╔════╝
║   ██████╔╝██╔████╔██║    ███████╗█████╔╝ ██║██║     ██║     ███████╗
║   ██╔═══╝ ██║╚██╔╝██║    ╚════██║██╔═██╗ ██║██║     ██║     ╚════██║
║   ██║     ██║ ╚═╝ ██║    ███████║██║  ██╗██║███████╗███████╗███████║
║   ╚═╝     ╚═╝     ╚═╝    ╚══════╝╚═╝  ╚═╝╚═╝╚══════╝╚══════╝╚══════╝
║                                                                    ║
║   47 battle-tested skills + 6 command workflows                    ║
║   Claude Code • Cursor • Codex  • n8n • OpenClaw • and more ...    ║
║                                                                    ║
║   v0.75 • Mar 17, 2026 • CC BY-NC-SA 4.0                           ║
╚════════════════════════════════════════════════════════════════════╝

Help product managers become more awesome at their craft — and help them send the ladder down to others.

Battle-tested PM frameworks that teach both you and your AI agents how to do product management work at a professional level. You learn the why. Your agents execute the how. Everyone gets better.

Frame problems, hunt opportunities, scaffold validation experiments, and kill bad bets fast. With frameworks from Teresa Torres, Geoffrey Moore, Amazon, MITRE, and much more from product management's greatest hits.

📣 Updates & Announcements

Mar 17, 2026 — v0.75 Pedagogic-First: Restoring What This Repo Is Actually For

I want to apologize to a contributor who recently submitted a well-intentioned and well-coded improvement that stripped learning scaffolding in favor of tighter copy. It wasn't their fault — the docs they read never crisply stated that pedagogic value is non-negotiable. We fixed that. I will work with that contribution to bring in its efficiencies while retaining the learning aspects of the skills.

What this repo is actually for: As much as this repo is for adding skills to your agent, it's equally tasked to help product managers become more awesome at their craft, and helping them send the ladder down to others. Skills here serve both goals: they make your agent more capable, and they make you more knowledgeable about why the framework works. Neither is a byproduct of the other.

ABC — Always Be Coaching is a key governing principle. Every skill should leave the person using it knowing more than when they started. Stripping explanation to tighten output is a defect, not an improvement.

What changed in v0.75:

README.md — Mission statement updated to name both audiences: human PMs and AI agents
CONTRIBUTING.md — New Design Philosophy section so contributors know what they're protecting
CLAUDE.md — Pedagogic-first added to the agent's mandate, not just the style guide
AGENTS.md — New Operating Philosophy section so coding agents don't optimize away the teaching

Release note: docs/announcements/2026-03-17-v0-75-pedagogic-first.md

Now available: Install skills directly from Claude Code via the plugin marketplace:

/plugin marketplace add deanpeters/Product-Manager-Skills
/plugin install jobs-to-be-done@pm-skills

Mar 9, 2026 — v0.7 Sharper Skills, Faster Discovery

This release is about making the library easier to trust and easier to use.

As this repo grows, the standard has to rise with it. So v0.7 focuses on the parts users actually feel:

finding the right skill faster,
understanding when to use it,
getting cleaner activation behavior,
and trusting that the repo is being actively tightened, not just expanded.

Why it matters:

You spend less time guessing which skill to use.
Skills are more likely to show up in the situations where you actually need them.
The library becomes easier to navigate as it grows, not more chaotic.
Quality becomes a maintained promise, not a one-time cleanup.

What shipped:

Trigger-oriented description updates across the skill library so skills answer both "what it does" and "use this when..."
New intent frontmatter field so every skill can keep a sharp trigger description and a richer deeper-purpose summary
New trigger-readiness auditing in scripts/check-skill-triggers.py
Trigger checks wired into scripts/test-library.sh
New find-a-skill.sh --mode trigger for discovering skills by use-case language, best_for, and scenarios
New Streamlit (beta) Find My Skill mode so users can describe a situation in plain English and get recommended skills with clear next actions
Streamlit navigation now separates Learn, Find My Skill, and Run Skills so first-time users can move from confusion to action faster
Contributor docs updated so future skills follow the same tighter standard
Cross-checked the tighter standard against Anthropic's Complete Guide to Building Skills for Claude

Release note: docs/announcements/2026-03-09-v0-7-skill-quality-trigger-clarity.md

Mar 8, 2026 — v0.65 You Asked, We Listened: Setup + Integration Everywhere

You asked, we listened. We took a moment to create comprehensive instructions on how to install, integrate, or otherwise use any one or all of these skills.

What shipped:

docs/Using PM Skills 101.md as the complete beginner-first guide
docs/Platform Guides for PMs.md as the pick-your-tool index
docs/Using PM Skills with Slash Commands 101.md for Claude /slash workflows like /pm-story and /pm-prd
New PM-friendly platform docs for Claude Code, Claude Desktop, Claude Cowork, ChatGPT Desktop, OpenClaw, n8n, LangFlow, and Python agents
Updated START_HERE.md with comfort-level paths (chat-first, terminal-first, automation-first)

How to make the best use of this release:

Start with docs/Using PM Skills 101.md
Choose your platform in docs/Platform Guides for PMs.md
Run one real task with one skill before scaling to multi-skill workflows

Release note: docs/announcements/2026-03-08-v0-65-onboarding-integration-guides.md

We added a command layer and fast navigation system while keeping skills as the source of truth.

What shipped:

START_HERE.md for 60-second onboarding
commands/ directory with reusable multi-skill workflows
catalog/ generated indexes for quick browsing
New helper scripts: run-pm.sh, find-a-command.sh, test-library.sh, and generate-catalog.py
Command validation with scripts/check-command-metadata.py

Release note draft: docs/announcements/2026-03-06-v0-6-navigation-commands.md

Feb 27, 2026 — v0.5 Streamlit (beta) Playground

We launched a new Streamlit (beta) interface for local skill test-driving.

What shipped:

Local playground at app/main.py with guided browsing and session flows
Multi-provider support (Anthropic, OpenAI, Ollama) with provider/model picker
Environment-variable-only API handling (app/.env.example) for safer defaults
Workflow UX upgrades (phase detection fix, per-phase output persistence, run-all phases control)
Fast-model quality warnings on long workflows (especially PRD-style runs)

Docs:

Feedback welcome:

Feb 27, 2026 — v0.5 Career & Leadership Skills Suite

Four new skills covering the full product leadership career arc — from PM to Director to VP/CPO — distilled from two episodes of The Product Porch podcast.

Based on Episode 42 — From PM to Director: How to Make the Shift (Part 1):

altitude-horizon-framework (Component) — The core mental model: altitude (scope) and horizon (time), the waiter-to-operator shift, four transition zones, named failure modes, and the Cascading Context Map
director-readiness-advisor (Interactive) — Coaches PMs and new Directors across four situations: preparing, interviewing, newly landed, and recalibrating

Based on Episode 43 — Becoming a VP & CPO: Leading Product at the Executive Level (Part 2):

executive-onboarding-playbook (Workflow) — A 30-60-90 day diagnostic playbook for VP/CPO transitions: diagnose before acting, surface unwritten strategy, assess people, act with evidence
vp-cpo-readiness-advisor (Interactive) — Coaches Directors and executives through the VP/CPO transition, including the CEO interview framework for evaluating roles before accepting

Feb 10, 2026 — v0.4 Facilitation Protocol Fix

We found and fixed a facilitation regression in interactive flows.

What happened:

We expected guided, step-by-step facilitation with progressive context handling.
In practice, a brevity-focused rewrite path stripped out parts of the original facilitation modality (especially the "walk through questions" behavior).

What we changed in v0.4:

Standardized a canonical facilitation protocol in skills/workshop-facilitation/SKILL.md.
Rolled that source-of-truth linkage across interactive skills and facilitation-heavy workflow skills.
Added mandatory session heads-up, Context dump bypass, and Best guess mode.
Added stronger progress labels, interruption handling, and decision-point recommendation rules.

Credit:

Codex identified the protocol mismatch and implemented the fix across the repo.

Announcement draft: docs/announcements/2026-02-10-v0-4-facilitation-fix.md

Feb 8, 2026 — LinkedIn Launch

Post title: Product Management Skills for Your Agents
Subtitle: Because "just prompt better" is not a strategy.

Still rewriting PM prompts and getting generic AI output? I built a reusable PM Skills repo to help you make sharper decisions, docs, and outcomes faster.

Full announcement draft: docs/announcements/2026-02-08-linkedin-launch.md
Substack article draft: docs/announcements/2026-02-08-substack-savage-launch.md
Announcements index: docs/announcements/README.md
Skills repo: Product Manager Skills
Prior prompts repo: Product Manager Prompts

🎯 What This Is

47 ready-to-use PM skills + reusable command workflows that teach both you and your AI agents how to do product management work at a professional level — so the PM understands the why and the agent can execute the how.

Instead of saying "Write a PRD" and hoping for the best, you and your agent both know:

✅ How to structure a PRD and why each section earns its place
✅ What questions to ask stakeholders and what you're listening for
✅ Which prioritization framework to use (and when each one breaks down)
✅ How to run customer discovery interviews and what signals matter
✅ How to break down epics using proven patterns — and the tradeoffs of each

Result: You work faster, with better consistency, at a higher strategic level — and you can explain why.

Works with: Claude Code, Cowork, OpenAI Codex, ChatGPT, Gemini, and any AI agent that can read structured knowledge.

🎓 Design Philosophy — Pedagogic and Practical in Equal Measure

As much as this repo is for adding skills to your agent, it's equally tasked to help product managers become more awesome at their craft — and to help them send the ladder down to others.

Skills here serve both goals simultaneously. They equip AI agents to do PM work at a professional level, and they teach the human PM the why behind the framework — so they can explain it, adapt it, and pass it on.

ABC — Always Be Coaching is a key governing principle. Every skill should leave the person using it knowing more than when they started.

This means:

Skills explain reasoning, not just steps
Examples show the thinking, not just the output
Anti-patterns name the failure mode so you recognize it in the wild
Interactive skills coach through discovery — they don't just collect answers

An edit that strips learning scaffolding to tighten copy is a defect, not an improvement.

⚡ Start in 60 Seconds

New here? Start with START_HERE.md.

# Run a skill (artifact/analysis)
./scripts/run-pm.sh skill prioritization-advisor "We have 12 requests and one sprint"

# Run a command (multi-skill workflow)
./scripts/run-pm.sh command discover "Reduce onboarding drop-off for self-serve users"

Need discovery first?

./scripts/find-a-skill.sh --keyword onboarding
./scripts/find-a-command.sh --keyword roadmap

Why The Command Layer Helps

Commands make using skills easier without replacing skills.

Skills stay deep and pedagogic: they are the source of truth for frameworks, reasoning, and quality — for humans and agents alike.
Commands remove stitching work: one command chains the right skills in the right order.
You start faster: less "which skill should I run first?" and fewer manual handoffs.
Outputs are more consistent: commands enforce checkpoints, then defer to skill-level rigor.
Teams onboard quicker: new users can run /discover or /write-prd and learn the skill system while shipping.

In short: skills provide expertise; commands provide momentum.

🧪 Streamlit (beta)

Want a quick local test-drive before using skills in your agent workflow?

pip install -r app/requirements.txt
streamlit run app/main.py

What you can do in v0.7:

Learn setup and integration paths without leaving the app
Find My Skill by describing your situation in plain English
Run Skills with your own scenario once you know what you want

This beta interface is a feature in flight. Feedback is welcome via GitHub Issues or LinkedIn.

✅ Safety and Evaluation

Before using any skill:

Review the skill file and any linked resources. If it includes scripts/, read them before running.
Prefer least privilege. Skills should not require secrets or network access unless explicitly documented.
Do a quick dry run with a realistic prompt, then refine name and description for better discoverability.
Run python3 scripts/check-skill-triggers.py --show-cases before packaging if you want a quick trigger-readiness pass.

🧰 Optional Scripts (Deterministic Helpers)

Some skills include a scripts/ folder with deterministic helpers for calculations or formatting. These are optional, should be audited before running, and should avoid network calls or external dependencies.

Examples:

skills/tam-sam-som-calculator/scripts/market-sizing.py
skills/user-story/scripts/user-story-template.py

🤖 Skill Creation Utility

Want to create your own skills? Choose one of these utilities:

scripts/add-a-skill.sh - Content-first, AI-assisted generation from notes/frameworks.
scripts/build-a-skill.sh - Guided "build-a-bear" wizard that prompts section-by-section.
scripts/find-a-skill.sh - Search skills by name/type/keyword with ranked results.
scripts/find-a-command.sh - Search commands by name/keyword/used skills.
scripts/run-pm.sh - Fast runner for either a skill or a command.
scripts/test-a-skill.sh - Run strict conformance checks and optional smoke checks.
scripts/check-skill-triggers.py - Audit frontmatter descriptions and scenario prompts for Claude-style triggering.
scripts/test-library.sh - Validate skills, commands, and regenerate catalogs.
scripts/zip-a-skill.sh - Build upload-ready .zip files by skill, type, or all skills.
scripts/generate-catalog.py - Regenerate skill/command navigation indexes.

New to terminals? See scripts/README.md for a plain-language walkthrough.
Power users: These scripts are designed to chain together into fast end-to-end workflows (idea -> prompt -> validation -> packaging).

What it does:

Analyzes your content and suggests skill types
Generates complete skill files with examples
Validates metadata for marketplace compliance
Updates documentation automatically

Usage:

# From a file
./scripts/add-a-skill.sh research/your-framework.md

# Guided wizard
./scripts/build-a-skill.sh

# Find a skill
./scripts/find-a-skill.sh --keyword pricing --type interactive

# Find a command
./scripts/find-a-command.sh --keyword roadmap

# Run a command workflow
./scripts/run-pm.sh command write-prd "Mobile onboarding redesign"

# Test one skill
./scripts/test-a-skill.sh --skill finance-based-pricing-advisor --smoke

# Test full library surface
./scripts/test-library.sh

# Build Claude upload zip for one skill
./scripts/zip-a-skill.sh --skill finance-based-pricing-advisor

# Build Claude upload zips for all skills
./scripts/zip-a-skill.sh --all --output dist/skill-zips

# Build Claude upload zips for one category (component|interactive|workflow)
./scripts/zip-a-skill.sh --type component --output dist/skill-zips

# Build curated starter pack
./scripts/zip-a-skill.sh --preset core-pm --output dist/skill-zips

# Show available curated presets
./scripts/zip-a-skill.sh --list-presets

# From clipboard
pbpaste | ./scripts/add-a-skill.sh

# Check available adapters
./scripts/add-a-skill.sh --list-agents

Agent support: Claude Code, Manual mode (works with any CLI), and custom adapters via scripts/adapters/ADAPTER_TEMPLATE.sh

Learn more: See docs/Add-a-Skill Utility Guide.md for complete guide.
Cloning locally? Start with docs/Building PM Skills.md#local-clone-quickstart.

✅ Claude Web Upload Checklist

Keep frontmatter name <= 64 chars and description <= 200 chars.
Use intent for the richer repo-facing explanation of the skill, while keeping description short and trigger-oriented.
Ensure the skill folder name matches the name value.
Use scripts/zip-a-skill.sh --skill <skill-name> (or --type component, --preset core-pm) to generate upload-ready ZIPs.
(Advanced) Use scripts/package-claude-skills.sh if you need unpacked upload-ready folders.
Validate metadata with scripts/check-skill-metadata.py.
For GitHub ZIP upload flow, see docs/Using PM Skills with Claude.md.

🏗️ Three-Tier Architecture (How Skills Work Together)

These 47 skills are organized into three types that build on each other:

┌───────────────────────────────────────────────────────────┐
│  WORKFLOW SKILLS (6)                                      │
│  Complete end-to-end PM processes                         │
│  Example: "Run a product strategy session"                │
│  Timeline: 2-4 weeks                                      │
└───────────────────────────────────────────────────────────┘
                         ↓ orchestrates
┌───────────────────────────────────────────────────────────┐
│  INTERACTIVE SKILLS (20)                                  │
│  Guided discovery with adaptive questions                 │
│  Example: "Which prioritization framework should I use?"  │
│  Timeline: 30-90 minutes                                  │
└───────────────────────────────────────────────────────────┘
                         ↓ uses
┌───────────────────────────────────────────────────────────┐
│  COMPONENT SKILLS (21)                                    │
│  Templates for specific PM deliverables                   │
│  Example: "Write a user story"                            │
│  Timeline: 10-30 minutes                                  │
└───────────────────────────────────────────────────────────┘

Component Skills (21) — Templates & Artifacts

What: Reusable templates for creating specific PM deliverables (user stories, positioning statements, epics, personas, PRDs, etc.)

When to use: You need a standard template or format for a specific deliverable.

Example: "Write a user story with acceptance criteria" → Use user-story.md

Interactive Skills (20) — Guided Discovery

What: Multi-turn conversational flows where AI asks you 3-5 adaptive questions, then offers smart recommendations based on your context.

When to use: You need help deciding which approach to take or gathering context before executing.

Example: "Which prioritization framework should I use?" → Run prioritization-advisor.md, which asks about your product stage, team size, data availability, then recommends RICE, ICE, Kano, or other frameworks.

How they work:

AI asks 3-5 questions about your context
You answer (or pick from numbered options)
AI offers 3-5 tailored recommendations
You choose one (or combine approaches)
AI executes using the right component skills

Workflow Skills (6) — End-to-End Processes

What: Complete PM processes that orchestrate multiple component and interactive skills over days/weeks.

When to use: You need to run a full PM workflow from start to finish (strategy session, discovery cycle, roadmap planning, PRD creation).

Example: "Align stakeholders on product strategy" → Run product-strategy-session.md, which guides you through positioning → problem framing → solution exploration → roadmap planning over 2-4 weeks.

📦 All 47 Skills (Clickable)

Now that you understand the three types, here's the complete catalog:

🧱 Component Skills (21)

Skill	Use When You Need To...
altitude-horizon-framework	Understand the PM→Director mindset shift: altitude (scope), horizon (time), four transition zones, failure modes, and the Cascading Context Map. Based on The Product Porch E42
company-research	Deep-dive competitor or company analysis
customer-journey-map	Map customer experience across all touchpoints (NNGroup framework)
eol-message	Communicate product/feature deprecation gracefully
epic-hypothesis	Turn vague initiatives into testable hypotheses with success metrics
finance-metrics-quickref	Fast lookup table for 32+ SaaS finance metrics with formulas, benchmarks, and when to use each
jobs-to-be-done	Understand what customers are trying to accomplish (JTBD framework)
pestel-analysis	Analyze external factors (Political, Economic, Social, Tech, Environmental, Legal)
pol-probe	Define lightweight, disposable validation experiments to test hypotheses before building (Dean Peters PoL framework)
positioning-statement	Define who you serve, what problem you solve, and how you're different (Geoffrey Moore framework)
press-release	Write a future press release to clarify product vision (Amazon Working Backwards)
problem-statement	Frame a customer problem with evidence before jumping to solutions
product-sense-interview-answer	Structure a spoken product-sense answer with assumptions, segmentation, pain-point prioritization, and MVP tradeoffs
proto-persona	Create hypothesis-driven personas before doing full research
recommendation-canvas	Document AI-powered product recommendations
saas-economics-efficiency-metrics	Evaluate unit economics and capital efficiency (CAC, LTV, payback, margins, burn rate, Rule of 40, magic number)
saas-revenue-growth-metrics	Calculate and interpret revenue, retention, and growth metrics (revenue, ARPU, MRR/ARR, churn, NRR, expansion)
storyboard	Visualize user journeys with 6-frame narrative storyboards
user-story	Write user stories with proper acceptance criteria (Mike Cohn + Gherkin)
user-story-mapping	Organize stories by user workflow (Jeff Patton framework)
user-story-splitting	Break down large stories using 8 proven patterns

🔄 Interactive Skills (20)

Skill	What It Does
acquisition-channel-advisor	Evaluate acquisition channels using unit economics, customer quality, and scalability. Recommends scale/test/kill decisions
ai-shaped-readiness-advisor	Assess if you're "AI-first" (automating tasks) or "AI-shaped" (redesigning how you work). Evaluates 5 competencies and recommends which to build first
business-health-diagnostic	Diagnose SaaS business health using key metrics, identify red flags, and prioritize actions. Analyzes growth, retention, efficiency, and capital health
context-engineering-advisor	Diagnose context stuffing (volume without intent) vs. context engineering (structure for attention). Guides memory architecture, retrieval strategies, and Research→Plan→Reset→Implement cycle
customer-journey-mapping-workshop	Guides journey mapping with pain point identification
director-readiness-advisor	Coaches PMs and new Directors through the transition across four situations: preparing, interviewing, newly landed, recalibrating. Based on The Product Porch E42
discovery-interview-prep	Plans customer interviews (Mom Test style) based on your research goals
epic-breakdown-advisor	Splits epics into user stories using Richard Lawrence's 9 patterns
feature-investment-advisor	Evaluate feature investments using revenue impact, cost structure, ROI, and strategic value. Delivers build/don't build recommendations
finance-based-pricing-advisor	Evaluate pricing changes using financial impact analysis (ARPU/ARPA, conversion, churn risk, NRR, payback)
lean-ux-canvas	Sets up hypothesis-driven planning (Jeff Gothelf Lean UX Canvas v2)
opportunity-solution-tree	Generates opportunities and solutions, recommends best proof-of-concept to test
pol-probe-advisor	Recommends which of 5 prototype types to use based on your hypothesis and risk (Feasibility, Task-Focused, Narrative, Synthetic Data, Vibe-Coded)
positioning-workshop	Guides you through defining your positioning with adaptive questions
prioritization-advisor	Recommends the right prioritization framework (RICE, ICE, Kano, etc.) for your situation
problem-framing-canvas	Leads you through MITRE Problem Framing (Look Inward/Outward/Reframe)
tam-sam-som-calculator	Projects market size (TAM/SAM/SOM) with real-world data and citations
user-story-mapping-workshop	Walks you through creating story maps with backbone and release slices
vp-cpo-readiness-advisor	Coaches Directors and executives through the VP/CPO transition — includes CEO interview framework for evaluating roles before accepting. Based on The Product Porch E43
workshop-facilitation	Adds one-step-at-a-time facilitation with numbered recommendations for workshop skills

🎭 Workflow Skills (6)

Skill	What It Does	Timeline
discovery-process	Complete discovery cycle: frame problem → research → synthesize → validate solutions	3-4 weeks
executive-onboarding-playbook	30-60-90 day diagnostic playbook for VP/CPO transitions: diagnose before acting, surface unwritten strategy, assess people, act with evidence. Based on The Product Porch E43	90 days
prd-development	Structured PRD: problem statement → personas → solution → metrics → user stories	2-4 days
product-strategy-session	Full strategy: positioning → problem framing → solution exploration → roadmap	2-4 weeks
roadmap-planning	Strategic roadmap: gather inputs → define epics → prioritize → sequence → communicate	1-2 weeks
skill-authoring-workflow	Meta workflow: choose add/build path → validate conformance → update docs → package/publish	30-90 minutes

🔮 Agent Skills of the Future

Possible skills in development:

Dangerous Animals of Product Management - Feature hostage negotiations and stakeholder shuttle diplomacy for when you're facing HiPPOs, RHiNOs, and WoLFs (oh my!).
Pricing for Product Managers - Value-based pricing, packaging strategy, price increases, and grandfather clause negotiations without the panic spiral and flop sweat.
Classic Business Strategy Frameworks - Ansoff, BCG, Porter's 5 Forces, Blue Ocean, and SWOT in agent-ready format that helps you decide, not decorate slides.
Storytelling for Product Managers - Narrative arc, demo choreography, and pitch structure built on pro-opera lessons and Hakawati orations for commanding the room.
Prompt Building for Product Managers - Industrial-strength prompt engineering: team session starters, multi-turn workflow wizards, and reverse engineering templates for artifacts like PRDs.
Nightmares of Product Management - Telemetry, triage, and tactics for when things don't go as planned: adoption theater, feature graveyards, metric manipulation, launch amnesia, technical debt wildfires. Plus prevention strategies.

Detailed concept notes live in PLANS.md.

🚀 How to Use

Confused by setup options? Start here: PM Skills Rule-of-Thumb Guide.

Fastest Path (Local Repo)

# Skill mode
./scripts/run-pm.sh skill user-story "Checkout improvements for returning customers"

# Command mode
./scripts/run-pm.sh command plan-roadmap "Q3-Q4 roadmap for enterprise reporting"

Command definitions live in commands/, and generated browse indexes live in catalog/.

With Claude Desktop or Claude.ai

Open a conversation with Claude
Share the skill file: "Read user-story.md"
Ask Claude to apply it: "Using the User Story skill, write stories for our checkout flow"

With Claude Code (CLI)

cd product-manager-skills
claude "Using the PRD Development workflow, create a PRD for our mobile feature"

You can discover via npx skills find <query> and npx skills add deanpeters/Product-Manager-Skills --list, then install for Claude Code. See Using PM Skills with Claude.

With OpenAI Codex

Use local workspace paths, GitHub-connected Codex on ChatGPT, or discover/install directly with npx skills. See Using PM Skills with Codex.

With ChatGPT

Use GitHub app connections (formerly connectors), Custom GPT Knowledge uploads, or Project files. See Using PM Skills with ChatGPT.

With Cowork or Other Agents

Cowork: Import skills as knowledge modules, invoke via natural language.
Other agents: Follow your agent's docs for loading custom knowledge.

📄 Docs

Using PM Skills 101 — Beginner-friendly orientation for PMs who want clear setup without technical overload.
Using PM Skills with Claude — Claude Code usage plus GitHub ZIP upload steps for Claude Desktop/Web.
Using PM Skills with Codex — Local workspace usage plus GitHub-connected Codex on ChatGPT.
Using PM Skills with ChatGPT — GitHub app connection, Custom GPT Knowledge setup, and Project-based usage.
Platform Guides for PMs — Tool-by-tool setup chooser for Claude Code, Codex, OpenClaw, Cowork, Claude Desktop, ChatGPT Desktop, n8n, LangFlow, and Python agents.
Using PM Skills with Claude Code — PM-focused quickstart for Claude Code users.
Using PM Skills with Slash Commands 101 — Turn PM skills into reusable Claude slash commands like /pm-story and /pm-prd.
Using PM Skills with Claude Desktop — Skill upload workflow for non-technical desktop users.
Using PM Skills with ChatGPT Desktop — Project-first setup for desktop-based PM work.
Using PM Skills with n8n — Practical automation patterns for repeatable PM workflows.
Using PM Skills with LangFlow — Visual workflow setup using skill-guided prompt templates.
Additional harness guides: Cursor, Windsurf, Bolt, Replit Agent, Make.com, Devin, CrewAI, Gemini
Start Here — One-page "do this now" onboarding for skills and commands.
Commands — Command format, command list, validation, and discovery.
Catalog Artifacts — Generated skill/command indexes for fast navigation.
PM Skills Rule-of-Thumb Guide — Non-technical setup choices (local repo vs ZIP vs app connections) in plain English.
Marketplace Strategy — PM-friendly strategy for distributing skills in marketplaces.
Marketplace Submission Runbook — Step-by-step submission workflow for non-technical teams.
Marketplace Issue Templates — Reusable issue templates for marketplace execution and tracking.
PM Tooling Operations Charter — Pedagogic operating stack across M365 Copilot, Codex, ChatGPT, VS Code/Copilot, Cursor, n8n, and Lovable.
Add-a-Skill Utility Guide — End-to-end automation guide for generating and validating new skills.
Building PM Skills — How we distill sources into agent-ready PM skills.

💼 Real-World Use Cases

"I need to align stakeholders on product strategy"

→ Workflow: product-strategy-session (2-4 weeks, orchestrates positioning → roadmap)

"I need to validate a customer problem before building"

→ Workflow: discovery-process (3-4 weeks, interviews → synthesis → validation)

"I need to test a hypothesis quickly before investing in development"

→ Interactive: pol-probe-advisor (recommends which prototype type: Feasibility, Task-Focused, Narrative, Synthetic Data, or Vibe-Coded)
→ Component: pol-probe (template for documenting validation experiments)

"I want to know if I'm using AI strategically or just for efficiency"

→ Interactive: ai-shaped-readiness-advisor (assesses 5 competencies: Context Design, Agent Orchestration, Outcome Acceleration, Team-AI Facilitation, Strategic Differentiation)

"I'm pasting entire docs into AI and getting vague responses"

→ Interactive: context-engineering-advisor (diagnose context stuffing vs. engineering, define boundaries, implement Research→Plan→Reset→Implement cycle)

"I need to write a PRD for a new feature"

→ Workflow: prd-development (2-4 days, problem → solution → stories)

"I need to create a Q2 roadmap"

→ Workflow: roadmap-planning (1-2 weeks, epics → prioritization → sequencing)

"I need to choose a prioritization framework"

→ Interactive: prioritization-advisor (asks questions, recommends RICE/ICE/Kano)

"I need to split a large epic"

→ Interactive: epic-breakdown-advisor (Richard Lawrence's 9 patterns)

"I need to write a user story"

→ Component: user-story (template + examples)

💡 Why Skills Beat Prompts

Prompts	Skills
One-time instructions per task	Reusable frameworks learned once
"Write a PRD for X"	Agent knows PRD structure, asks smart questions, handles edge cases
You repeat yourself constantly	Agent remembers best practices
Inconsistent outputs	Consistent, professional results

Skills = Less explaining, more strategic work.

🌟 What Makes These Skills Different

✅ Battle-Tested Frameworks

Built on proven methods from Geoffrey Moore, Jeff Patton, Teresa Torres, Amazon, Richard Lawrence, MITRE, and more.

✅ Real Client Work

Based on decades of PM consulting across healthcare, finance, manufacturing, and tech.

✅ Agent-Ready Format

Optimized for AI comprehension—not blog posts, not books, not courses. Executable frameworks.

✅ Zero Fluff

Every word earns its keep. No filler, no buzzwords, no generic advice.

✅ Example-Rich

Shows both "good" and "bad" examples so you know what works and what to avoid.

📚 Skill Structure (What's Inside Each File)

Every skill follows the same format:

## Purpose
What this skill does and when to use it.

## Key Concepts
Core frameworks, definitions, anti-patterns.

## Application
Step-by-step instructions (with examples).

## Examples
Real-world cases (good and bad).

## Common Pitfalls
What to avoid and why.

## References
Related skills and external frameworks.

Clean. Practical. Zero fluff.

🤝 Contributing

Found a gap? Have a PM framework you'd like to see included?

Ways to contribute:

Open an issue with your suggestion
Submit a pull request (we'll help you format it)
Share feedback on what's working or missing

See CONTRIBUTING.md for detailed guidelines.

🎓 Philosophy

Principles:

Outcome-driven over output-driven (solve problems, don't just ship features)
Evidence over vibes (validate with data, not opinions)
Clarity beats completeness (simple and usable beats comprehensive and confusing)
Examples beat explanations (show, don't just tell)

No hype. No buzzwords. Just frameworks that work.

Product Manager Prompts — Task-specific prompts for ChatGPT, Claude, Gemini
Productside — AI-powered product management training and consulting
Dean's LinkedIn — Essays on AI-amplified product work

📜 License

CC BY-NC-SA 4.0 — non-commercial use with share-alike.

See LICENSE for full details.

📞 Questions?

GitHub Issues: Report bugs or suggest features
LinkedIn: Connect with Dean Peters
Productside: Learn more about AI PM consulting

v0.7 — March 9, 2026

Highlights in this release:

Tightened skill descriptions so they communicate both what the skill does and when to use it
Added intent as a repo-standard frontmatter field to separate trigger metadata from deeper purpose
Added scripts/check-skill-triggers.py and wired trigger-readiness auditing into test-library.sh
Added find-a-skill.sh --mode trigger so users can discover skills through description, best_for, and scenarios
Added a Streamlit (beta) Find My Skill mode with plain-English discovery, recommended-first results, and direct preview/run actions
Updated authoring docs and templates so the stronger metadata standard sticks

v0.65 — March 8, 2026

Highlights in this release:

Added comprehensive PM-first onboarding and setup guide: docs/Using PM Skills 101.md
Added platform chooser: docs/Platform Guides for PMs.md
Added slash-command playbook: docs/Using PM Skills with Slash Commands 101.md
Added and linked practical platform docs for Claude Code/Desktop/Cowork, ChatGPT Desktop, OpenClaw, n8n, LangFlow, and Python agents
Updated START_HERE.md and docs navigation so new users can pick the right setup path faster

v0.6 — March 6, 2026

Highlights in this release:

Added commands/ with reusable workflow wrappers over local skills (discover, strategy, write-prd, plan-roadmap, prioritize, leadership-transition)
Added START_HERE.md for 60-second onboarding
Added generated catalog/ artifacts for fast skill and command navigation
Added tooling for discovery/validation/execution: find-a-command.sh, run-pm.sh, check-command-metadata.py, test-library.sh, generate-catalog.py

v0.5 — February 27, 2026

Highlights in this release:

Added 4 Career & Leadership skills distilled from The Product Porch episodes on PM→Director and Director→VP/CPO transitions
Launched Streamlit (beta) local playground in app/ with multi-provider/model selection
Improved workflow UX in beta app: phase detection, explicit run controls, and per-phase output tracking

v0.4 — February 10, 2026

Highlights in this release:

Fixed a facilitation protocol regression where brevity-focused rewrites could remove expected guided-question behavior
Promoted workshop-facilitation to canonical source of truth for interactive facilitation
Added consistent opening heads-up, context-dump bypass path, and best-guess mode
Applied protocol linkage across interactive skills and facilitation-heavy workflow skills

v0.3 — February 9, 2026

Highlights in this release:

42 total skills, including Phase 7 finance skills and the new skill-authoring-workflow
New skill tooling: add-a-skill, build-a-skill, find-a-skill, test-a-skill, zip-a-skill
New onboarding docs for Claude, Codex, ChatGPT, and non-technical "rule-of-thumb" setup

Built by Dean Peters (Principal Consultant and Trainer at Productside.com) with Anthropic Claude and OpenAI Codex.

Helping product managers work smarter with AI.

Product Manager Skills

📣 Updates & Announcements

Mar 17, 2026 — v0.75 Pedagogic-First: Restoring What This Repo Is Actually For

Mar 9, 2026 — v0.7 Sharper Skills, Faster Discovery

Why it matters:

What shipped:

Mar 8, 2026 — v0.65 You Asked, We Listened: Setup + Integration Everywhere

Mar 6, 2026 — v0.6 Navigation + Commands

Feb 27, 2026 — v0.5 Streamlit (beta) Playground

Feb 27, 2026 — v0.5 Career & Leadership Skills Suite

Feb 10, 2026 — v0.4 Facilitation Protocol Fix

Feb 8, 2026 — LinkedIn Launch

🎯 What This Is

🎓 Design Philosophy — Pedagogic and Practical in Equal Measure

⚡ Start in 60 Seconds

Why The Command Layer Helps

🧪 Streamlit (beta)

✅ Safety and Evaluation

🧰 Optional Scripts (Deterministic Helpers)

🤖 Skill Creation Utility

✅ Claude Web Upload Checklist

🏗️ Three-Tier Architecture (How Skills Work Together)

Component Skills (21) — Templates & Artifacts

Interactive Skills (20) — Guided Discovery

Workflow Skills (6) — End-to-End Processes

📦 All 47 Skills (Clickable)

🧱 Component Skills (21)

🔄 Interactive Skills (20)

🎭 Workflow Skills (6)

🔮 Agent Skills of the Future

🚀 How to Use

Fastest Path (Local Repo)

With Claude Desktop or Claude.ai

With Claude Code (CLI)

With OpenAI Codex

With ChatGPT

With Cowork or Other Agents

📄 Docs

💼 Real-World Use Cases

"I need to align stakeholders on product strategy"

"I need to validate a customer problem before building"

"I need to test a hypothesis quickly before investing in development"

"I want to know if I'm using AI strategically or just for efficiency"

"I'm pasting entire docs into AI and getting vague responses"

"I need to write a PRD for a new feature"

"I need to create a Q2 roadmap"

"I need to choose a prioritization framework"

"I need to split a large epic"

"I need to write a user story"

💡 Why Skills Beat Prompts

🌟 What Makes These Skills Different

✅ Battle-Tested Frameworks

✅ Real Client Work

✅ Agent-Ready Format

✅ Zero Fluff

✅ Example-Rich

📚 Skill Structure (What's Inside Each File)

🤝 Contributing

🎓 Philosophy

📖 Related Resources

📜 License

📞 Questions?