<a id="pmskills"></a>
# Product Manager Skills

![GitHub stars](https://img.shields.io/github/stars/deanpeters/Product-Manager-Skills?style=flat-square)
[![License: CC BY-NC-SA 4.0](https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-lightgrey?style=flat-square)](https://github.com/deanpeters/Product-Manager-Skills/blob/main/LICENSE)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen?style=flat-square)](https://github.com/deanpeters/Product-Manager-Skills/blob/main/CONTRIBUTING.md)
[![Version](https://img.shields.io/badge/version-v0.79-blue?style=flat-square)](https://github.com/deanpeters/Product-Manager-Skills)
[![Claude Code Plugin](https://img.shields.io/badge/Claude%20Code-Plugin%20Marketplace-5C4EE5?style=flat-square)](https://code.claude.com/docs/en/plugin-marketplaces)
![Skills](https://img.shields.io/badge/skills-49-informational?style=flat-square)
![Commands](https://img.shields.io/badge/commands-6-informational?style=flat-square)
![Streamlit Beta](https://img.shields.io/badge/streamlit-beta-orange?style=flat-square)

```text
╔════════════════════════════════════════════════════════════════════╗
║                                                                    ║
║   ██████╗ ███╗   ███╗    ███████╗██╗  ██╗██╗██╗     ██╗     ███████╗
║   ██╔══██╗████╗ ████║    ██╔════╝██║ ██╔╝██║██║     ██║     ██╔════╝
║   ██████╔╝██╔████╔██║    ███████╗█████╔╝ ██║██║     ██║     ███████╗
║   ██╔═══╝ ██║╚██╔╝██║    ╚════██║██╔═██╗ ██║██║     ██║     ╚════██║
║   ██║     ██║ ╚═╝ ██║    ███████║██║  ██╗██║███████╗███████╗███████║
║   ╚═╝     ╚═╝     ╚═╝    ╚══════╝╚═╝  ╚═╝╚═╝╚══════╝╚══════╝╚══════╝
║                                                                    ║
║   49 battle-tested skills + 6 command workflows                    ║
║   Claude Code • Cursor • Codex  • n8n • OpenClaw • and more ...    ║
║                                                                    ║
║   v0.79 • May 15, 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.

---

## Start Here

Choose your setup:

| I use... | Download/use this | Best for |
|---|---|---|
| Claude Desktop / Claude Web | [`pm-skills-starter-pack.zip`](https://github.com/deanpeters/Product-Manager-Skills/releases/latest/download/pm-skills-starter-pack.zip) | Nontechnical PMs |
| Claude Code | Plugin marketplace | Terminal users |
| Codex | [`pm-skills-codex.zip`](https://github.com/deanpeters/Product-Manager-Skills/releases/latest/download/pm-skills-codex.zip) or repo clone | Codex CLI/app users |
| I am not sure | [`pm-skills-starter-pack.zip`](https://github.com/deanpeters/Product-Manager-Skills/releases/latest/download/pm-skills-starter-pack.zip) | Most people |

### Fastest Path

Download the starter pack here:

**[`pm-skills-starter-pack.zip`](https://github.com/deanpeters/Product-Manager-Skills/releases/latest/download/pm-skills-starter-pack.zip)**

Unzip it. Inside, you will see individual skill ZIPs.

Upload those individual ZIPs to Claude Skills.

Ask:

```text
Use the Product Manager Skills to help me frame this product problem.
```

### Download ZIPs

All downloadable ZIPs live on the GitHub Releases page:

**[Open Product Manager Skills Releases](https://github.com/deanpeters/Product-Manager-Skills/releases/latest)**

Common downloads:

- Claude starter pack: [`pm-skills-starter-pack.zip`](https://github.com/deanpeters/Product-Manager-Skills/releases/latest/download/pm-skills-starter-pack.zip) - unzip this, then upload the skill ZIPs inside to Claude
- Claude discovery pack: [`02-discovery-pack.zip`](https://github.com/deanpeters/Product-Manager-Skills/releases/latest/download/02-discovery-pack.zip) - unzip this, then upload the skill ZIPs inside to Claude
- Claude strategy pack: [`03-strategy-pack.zip`](https://github.com/deanpeters/Product-Manager-Skills/releases/latest/download/03-strategy-pack.zip) - unzip this, then upload the skill ZIPs inside to Claude
- Claude delivery pack: [`04-delivery-pack.zip`](https://github.com/deanpeters/Product-Manager-Skills/releases/latest/download/04-delivery-pack.zip) - unzip this, then upload the skill ZIPs inside to Claude
- Claude AI PM pack: [`05-ai-pm-pack.zip`](https://github.com/deanpeters/Product-Manager-Skills/releases/latest/download/05-ai-pm-pack.zip) - unzip this, then upload the skill ZIPs inside to Claude
- Claude all-skills pack: [`99-all-skills-pack.zip`](https://github.com/deanpeters/Product-Manager-Skills/releases/latest/download/99-all-skills-pack.zip) - unzip this, then upload the skill ZIPs inside to Claude
- Codex package: [`pm-skills-codex.zip`](https://github.com/deanpeters/Product-Manager-Skills/releases/latest/download/pm-skills-codex.zip)

### Install Guides

- Claude Desktop/Web: [`docs/INSTALL-CLAUDE-DESKTOP.md`](docs/INSTALL-CLAUDE-DESKTOP.md)
- Claude Code: [`docs/INSTALL-CLAUDE-CODE.md`](docs/INSTALL-CLAUDE-CODE.md)
- Codex: [`docs/INSTALL-CODEX.md`](docs/INSTALL-CODEX.md)
- Release packaging for maintainers: [`docs/RELEASE-PACKAGING.md`](docs/RELEASE-PACKAGING.md)

---

## 📣 Updates & Announcements

### June 19, 2026 — v0.80 Stakeholder Suite: Three Skills from the MITRE Innovation Toolkit

Stakeholder work has been a gap in this library since day one. Every PM knows they should be doing it better — mapping who matters, understanding who's being underserved, planning engagement before the room gets political. And yet most of us default to a five-minute brainstorm that reliably captures the executives and misses the frontline users whose daily work the product will change.

This release adds three skills that cover the full stakeholder arc, adapted from the [MITRE Innovation Toolkit](https://itk.mitre.org) — a rigorous collection of human-centered design and facilitation tools developed by The MITRE Corporation. The ITK skills are excellent. What this adaptation does is translate them for a specific reader: the PM who is writing PRDs, running discovery sprints, aligning stakeholders before a roadmap review, and trying to make sure they haven't accidentally optimized for the loudest voices while the highest-impact users remain invisible.

A note on where these came from: the MITRE ITK skills were first adapted into an agent-ready format in a companion repo, [MITRE ITK Skills](https://github.com/deanpeters/MITRE-ITK-Skills), which translates all 27 ITK tools into structured skill files with PM-specific applications, key concepts, and common pitfalls. That repo is worth bookmarking if you work in discovery, facilitation, or cross-functional product strategy. The three skills in this release were then further refactored into PM Skills format — consolidated from five ITK tools into three, restructured to PM Skills anatomy, and in one case rebuilt entirely as an interactive Adaptive Decision Ladder flow.

**What changed in v0.80:**
- Added `skills/stakeholder-identification/` (Component) — comprehensive stakeholder brainstorm using Allies / Audiences / Influencers categorization, R/P/D marking (Resources, Permission, Decisions), an explicit equity lens, a bias and assumptions check, and a disciplined narrowing to the 2-3 priority targets to investigate first. Consolidates ITK Stakeholder Identification Canvas and Community Map.
- Added `skills/stakeholder-mapping/` (Component) — two complementary 2×2 grids: Power × Interest (assigns engagement strategy per stakeholder) and Impact × Power (surfaces who bears consequences but lacks organizational voice). The core pedagogic insight is comparing the two grids — the gaps between them reveal the stakeholders you're systematically under-engaging. Consolidates ITK Stakeholder Map & Matrix and Stakeholder Power Categories.
- Added `skills/stakeholder-engagement-advisor/` (Interactive) — per-stakeholder engagement planning through the Adaptive Decision Ladder. Three questions diagnose the stakeholder's profile, power/impact position, and engagement context; the advisor delivers a tailored engagement approach with key message framing, recommended medium and cadence, what you need from them versus what they need from you, and a named next action with owner and deadline. Adapts ITK Quickstart Stakeholder Engagement Canvas.

Source attribution: All three skills are adapted from the [MITRE Innovation Toolkit](https://itk.mitre.org), published by The MITRE Corporation (Approved for Public Release; Distribution Unlimited; Case #18-1663-5), via the [MITRE ITK Skills](https://github.com/deanpeters/MITRE-ITK-Skills) companion repo. Licensed CC BY-NC-SA 4.0, consistent with the ITK's original ShareAlike terms.

---

### May 15, 2026 — v0.79 Community Contributions: Thank You

This one belongs to the contributors.

Since v0.78, three members of the community spotted things we missed and showed up with fixes. @KNE-AI submitted `pm-skill-creator` — a new interactive skill that walks you through designing a repo-compliant skill from scratch via guided conversation, a genuinely useful addition to the meta-tooling. @xiaolai ran a full security audit of the repo's scripts and submitted two targeted fixes: a configurable input length guard in `run-pm.sh` and adapter name validation with path traversal protection in `add-a-skill.sh`. And @changyan01 and @harley-chenhailin caught a real bug: the missing `.claude-plugin/plugin.json` manifest that was silently preventing skill discovery for Claude Code users.

Every one of these contributions made the repo more useful for everyone. This is exactly the kind of community this project is trying to build.

**What changed in v0.79:**
- Added `skills/organic-growth-advisor/` — interactive McKinsey Growth Pyramid triage (L2–L5); three questions diagnose your growth constraint and recommend path-specific experiments for New Segments, New Geographies, New Distribution, or New Products. [Download skill zip](https://github.com/deanpeters/Product-Manager-Skills/releases/download/v0.79/organic-growth-advisor.zip)
- Added `skills/pm-skill-creator/` — interactive skill for guided skill design ([@KNE-AI](https://github.com/KNE-AI))
- Added configurable input length guard to `run-pm.sh` via `PM_MAX_INPUT` env var, default 4000 characters ([@xiaolai](https://github.com/xiaolai))
- Added adapter name validation and path traversal protection to `add-a-skill.sh` ([@xiaolai](https://github.com/xiaolai))
- Fixed missing `.claude-plugin/plugin.json` manifest that blocked skill discovery for Claude Code plugin users ([@changyan01](https://github.com/changyan01), [@harley-chenhailin](https://github.com/harley-chenhailin))

Release note: [`docs/announcements/2026-05-15-v0-79-community-contributions.md`](docs/announcements/2026-05-15-v0-79-community-contributions.md)

---

### Apr 26, 2026 — v0.78 Release Packaging: One Download, Then Better PM Work

This release makes Product Manager Skills easier to use outside the repo. The job is simple: when a PM wants to use these skills with Claude or Codex, they should not have to understand GitHub folders, packaging scripts, or agent internals first.

**Who this is for:** nontechnical PMs using Claude Desktop/Web, Claude Code users who prefer the plugin marketplace, Codex users who need `.agents/skills`, and maintainers who want releases to be repeatable instead of handmade.

**What changed in v0.78:**
- Claude Desktop/Web users get easy-button ZIP packs that contain individual upload-ready skill ZIPs, including a small starter pack and themed packs for discovery, strategy, delivery, and AI PM work
- Codex users get a `codex-product-manager-skills.zip` with `.agents/skills` and `AGENTS.md`
- Maintainers get one release command: `./scripts/build-release.sh`
- GitHub Actions now builds release artifacts on PRs, main, and version tags
- New install docs tell each audience which path to use

Why it matters: the repo now has a source, a shelf, a storefront, and a rescue desk. `skills/` remains the source of truth; `dist/` becomes the generated shelf; GitHub Releases becomes the storefront; and the README helps people choose the right path without feeling lost.

Release note: [`docs/announcements/2026-04-26-v0-78-release-packaging.md`](docs/announcements/2026-04-26-v0-78-release-packaging.md)

---

### 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`](docs/announcements/2026-03-17-v0-75-pedagogic-first.md)

**Now available:** Install skills directly from Claude Code via the plugin marketplace:
```bash
/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:
1. You spend less time guessing which skill to use.
2. Skills are more likely to show up in the situations where you actually need them.
3. The library becomes easier to navigate as it grows, not more chaotic.
4. 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](https://resources.anthropic.com/hubfs/The-Complete-Guide-to-Building-Skill-for-Claude.pdf)

Release note: [`docs/announcements/2026-03-09-v0-7-skill-quality-trigger-clarity.md`](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:
1. Start with [`docs/Using PM Skills 101.md`](docs/Using%20PM%20Skills%20101.md)
2. Choose your platform in [`docs/Platform Guides for PMs.md`](docs/Platform%20Guides%20for%20PMs.md)
3. 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`](docs/announcements/2026-03-08-v0-65-onboarding-integration-guides.md)

---

### Mar 6, 2026 — v0.6 Navigation + Commands

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`](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:
- [`app/STREAMLIT_INTERFACE.md`](app/STREAMLIT_INTERFACE.md)
- [`app/.env.example`](app/.env.example)

Feedback welcome:
- [GitHub Issues](https://github.com/deanpeters/Product-Manager-Skills/issues)
- [Dean on LinkedIn](https://linkedin.com/in/deanpeters)

---

<a id="leaderskills"></a>
### 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](https://the-product-porch-43ca35c0.simplecast.com) podcast.

**Based on Episode 42 — [From PM to Director: How to Make the Shift (Part 1)](https://the-product-porch-43ca35c0.simplecast.com/episodes/from-product-manager-to-director-how-to-make-the-shift-part-1):**
- [`altitude-horizon-framework`](skills/altitude-horizon-framework/SKILL.md) (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`](skills/director-readiness-advisor/SKILL.md) (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)](https://the-product-porch-43ca35c0.simplecast.com/episodes/becoming-a-vp-cpo-leading-product-at-the-executive-level-part-2):**
- [`executive-onboarding-playbook`](skills/executive-onboarding-playbook/SKILL.md) (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`](skills/vp-cpo-readiness-advisor/SKILL.md) (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`](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`](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`](docs/announcements/2026-02-08-linkedin-launch.md)
- Substack article draft: [`docs/announcements/2026-02-08-substack-savage-launch.md`](docs/announcements/2026-02-08-substack-savage-launch.md)
- Announcements index: [`docs/announcements/README.md`](docs/announcements/README.md)
- Skills repo: [Product Manager Skills](https://github.com/deanpeters/Product-Manager-Skills)
- Prior prompts repo: [Product Manager Prompts](https://github.com/deanpeters/product-manager-prompts)

---

## 🎯 What This Is

**49 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`](START_HERE.md).

```bash
# 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?

```bash
./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?

```bash
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](https://github.com/deanpeters/Product-Manager-Skills/issues) or [LinkedIn](https://linkedin.com/in/deanpeters).

---

## ✅ 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`](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:**
1. Analyzes your content and suggests skill types
2. Generates complete skill files with examples
3. Validates metadata for marketplace compliance
4. Updates documentation automatically

**Usage:**
```bash
# 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`](docs/Add-a-Skill%20Utility%20Guide.md) for complete guide.
**Cloning locally?** Start with [`docs/Building PM Skills.md#local-clone-quickstart`](docs/Building%20PM%20Skills.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`](docs/Using%20PM%20Skills%20with%20Claude.md#github-zip-install).

---

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

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

```text
┌───────────────────────────────────────────────────────────┐
│  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`](skills/user-story/SKILL.md)

---

### Interactive Skills (22) — 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`](skills/prioritization-advisor/SKILL.md), which asks about your product stage, team size, data availability, then recommends RICE, ICE, Kano, or other frameworks.

**How they work:**
1. AI asks 3-5 questions about your context
2. You answer (or pick from numbered options)
3. AI offers 3-5 tailored recommendations
4. You choose one (or combine approaches)
5. AI executes using the right component skills

---

### Workflow Skills (7) — 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`](skills/product-strategy-session/SKILL.md), which guides you through positioning → problem framing → solution exploration → roadmap planning over 2-4 weeks.

---

## 📦 All 50 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](skills/altitude-horizon-framework/SKILL.md)** | 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](https://the-product-porch-43ca35c0.simplecast.com/episodes/from-product-manager-to-director-how-to-make-the-shift-part-1) |
| **[company-research](skills/company-research/SKILL.md)** | Deep-dive competitor or company analysis |
| **[customer-journey-map](skills/customer-journey-map/SKILL.md)** | Map customer experience across all touchpoints (NNGroup framework) |
| **[eol-message](skills/eol-message/SKILL.md)** | Communicate product/feature deprecation gracefully |
| **[epic-hypothesis](skills/epic-hypothesis/SKILL.md)** | Turn vague initiatives into testable hypotheses with success metrics |
| **[finance-metrics-quickref](skills/finance-metrics-quickref/SKILL.md)** | Fast lookup table for 32+ SaaS finance metrics with formulas, benchmarks, and when to use each |
| **[jobs-to-be-done](skills/jobs-to-be-done/SKILL.md)** | Understand what customers are trying to accomplish (JTBD framework) |
| **[pestel-analysis](skills/pestel-analysis/SKILL.md)** | Analyze external factors (Political, Economic, Social, Tech, Environmental, Legal) |
| **[pol-probe](skills/pol-probe/SKILL.md)** | Define lightweight, disposable validation experiments to test hypotheses before building (Dean Peters PoL framework) |
| **[positioning-statement](skills/positioning-statement/SKILL.md)** | Define who you serve, what problem you solve, and how you're different (Geoffrey Moore framework) |
| **[press-release](skills/press-release/SKILL.md)** | Write a future press release to clarify product vision (Amazon Working Backwards) |
| **[problem-statement](skills/problem-statement/SKILL.md)** | Frame a customer problem with evidence before jumping to solutions |
| **[product-sense-interview-answer](skills/product-sense-interview-answer/SKILL.md)** | Structure a spoken product-sense answer with assumptions, segmentation, pain-point prioritization, and MVP tradeoffs |
| **[proto-persona](skills/proto-persona/SKILL.md)** | Create hypothesis-driven personas before doing full research |
| **[recommendation-canvas](skills/recommendation-canvas/SKILL.md)** | Document AI-powered product recommendations |
| **[saas-economics-efficiency-metrics](skills/saas-economics-efficiency-metrics/SKILL.md)** | Evaluate unit economics and capital efficiency (CAC, LTV, payback, margins, burn rate, Rule of 40, magic number) |
| **[saas-revenue-growth-metrics](skills/saas-revenue-growth-metrics/SKILL.md)** | Calculate and interpret revenue, retention, and growth metrics (revenue, ARPU, MRR/ARR, churn, NRR, expansion) |
| **[storyboard](skills/storyboard/SKILL.md)** | Visualize user journeys with 6-frame narrative storyboards |
| **[user-story](skills/user-story/SKILL.md)** | Write user stories with proper acceptance criteria (Mike Cohn + Gherkin) |
| **[user-story-mapping](skills/user-story-mapping/SKILL.md)** | Organize stories by user workflow (Jeff Patton framework) |
| **[user-story-splitting](skills/user-story-splitting/SKILL.md)** | Break down large stories using 8 proven patterns |

---

### 🔄 Interactive Skills (22)

| Skill | What It Does |
|-------|--------------|
| **[acquisition-channel-advisor](skills/acquisition-channel-advisor/SKILL.md)** | Evaluate acquisition channels using unit economics, customer quality, and scalability. Recommends scale/test/kill decisions |
| **[ai-shaped-readiness-advisor](skills/ai-shaped-readiness-advisor/SKILL.md)** | 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](skills/business-health-diagnostic/SKILL.md)** | Diagnose SaaS business health using key metrics, identify red flags, and prioritize actions. Analyzes growth, retention, efficiency, and capital health |
| **[context-engineering-advisor](skills/context-engineering-advisor/SKILL.md)** | 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](skills/customer-journey-mapping-workshop/SKILL.md)** | Guides journey mapping with pain point identification |
| **[director-readiness-advisor](skills/director-readiness-advisor/SKILL.md)** | Coaches PMs and new Directors through the transition across four situations: preparing, interviewing, newly landed, recalibrating. Based on [The Product Porch E42](https://the-product-porch-43ca35c0.simplecast.com/episodes/from-product-manager-to-director-how-to-make-the-shift-part-1) |
| **[discovery-interview-prep](skills/discovery-interview-prep/SKILL.md)** | Plans customer interviews (Mom Test style) based on your research goals |
| **[epic-breakdown-advisor](skills/epic-breakdown-advisor/SKILL.md)** | Splits epics into user stories using Richard Lawrence's 9 patterns |
| **[feature-investment-advisor](skills/feature-investment-advisor/SKILL.md)** | Evaluate feature investments using revenue impact, cost structure, ROI, and strategic value. Delivers build/don't build recommendations |
| **[finance-based-pricing-advisor](skills/finance-based-pricing-advisor/SKILL.md)** | Evaluate pricing changes using financial impact analysis (ARPU/ARPA, conversion, churn risk, NRR, payback) |
| **[lean-ux-canvas](skills/lean-ux-canvas/SKILL.md)** | Sets up hypothesis-driven planning (Jeff Gothelf Lean UX Canvas v2) |
| **[opportunity-solution-tree](skills/opportunity-solution-tree/SKILL.md)** | Generates opportunities and solutions, recommends best proof-of-concept to test |
| **[organic-growth-advisor](skills/organic-growth-advisor/SKILL.md)** | Identify which organic growth path to pursue — new segments, geographies, channels, or products. Use when diagnosing where a growth constraint lives and which McKinsey growth level to act on next |
| **[pm-skill-creator](skills/pm-skill-creator/SKILL.md)** | Design a new PM skill through guided conversation. Use when you have raw content or an idea and want to shape it into a compliant skill |
| **[pol-probe-advisor](skills/pol-probe-advisor/SKILL.md)** | Recommends which of 5 prototype types to use based on your hypothesis and risk (Feasibility, Task-Focused, Narrative, Synthetic Data, Vibe-Coded) |
| **[positioning-workshop](skills/positioning-workshop/SKILL.md)** | Guides you through defining your positioning with adaptive questions |
| **[prioritization-advisor](skills/prioritization-advisor/SKILL.md)** | Recommends the right prioritization framework (RICE, ICE, Kano, etc.) for your situation |
| **[problem-framing-canvas](skills/problem-framing-canvas/SKILL.md)** | Leads you through MITRE Problem Framing (Look Inward/Outward/Reframe) |
| **[tam-sam-som-calculator](skills/tam-sam-som-calculator/SKILL.md)** | Projects market size (TAM/SAM/SOM) with real-world data and citations |
| **[user-story-mapping-workshop](skills/user-story-mapping-workshop/SKILL.md)** | Walks you through creating story maps with backbone and release slices |
| **[vp-cpo-readiness-advisor](skills/vp-cpo-readiness-advisor/SKILL.md)** | Coaches Directors and executives through the VP/CPO transition — includes CEO interview framework for evaluating roles before accepting. Based on [The Product Porch E43](https://the-product-porch-43ca35c0.simplecast.com/episodes/becoming-a-vp-cpo-leading-product-at-the-executive-level-part-2) |
| **[workshop-facilitation](skills/workshop-facilitation/SKILL.md)** | Adds one-step-at-a-time facilitation with numbered recommendations for workshop skills |

---

### 🎭 Workflow Skills (7)

| Skill | What It Does | Timeline |
|-------|--------------|----------|
| **[company-intel](skills/company-intel/SKILL.md)** | Research and synthesize enterprises, industries, and niches through a PM lens — three modes: Industry, Company, and Prompt Architect — organized across seven research lenses including strategic signals (patents, hiring, leadership) | Per session |
| **[discovery-process](skills/discovery-process/SKILL.md)** | Complete discovery cycle: frame problem → research → synthesize → validate solutions | 3-4 weeks |
| **[executive-onboarding-playbook](skills/executive-onboarding-playbook/SKILL.md)** | 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](https://the-product-porch-43ca35c0.simplecast.com/episodes/becoming-a-vp-cpo-leading-product-at-the-executive-level-part-2) | 90 days |
| **[prd-development](skills/prd-development/SKILL.md)** | Structured PRD: problem statement → personas → solution → metrics → user stories | 2-4 days |
| **[product-strategy-session](skills/product-strategy-session/SKILL.md)** | Full strategy: positioning → problem framing → solution exploration → roadmap | 2-4 weeks |
| **[roadmap-planning](skills/roadmap-planning/SKILL.md)** | Strategic roadmap: gather inputs → define epics → prioritize → sequence → communicate | 1-2 weeks |
| **[skill-authoring-workflow](skills/skill-authoring-workflow/SKILL.md)** | Meta workflow: choose add/build path → validate conformance → update docs → package/publish | 30-90 minutes |

<a id="future-skills"></a>
### 🔮 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`](PLANS.md#future-skill-candidates).

---

## 🚀 How to Use

**Confused by setup options?** Start here: [PM Skills Rule-of-Thumb Guide](docs/PM%20Skills%20Rule-of-Thumb%20Guide.md).

### Fastest Path (Local Repo)

```bash
# 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/`](commands/README.md), and generated browse indexes live in [`catalog/`](catalog/README.md).

### With Claude Desktop or Claude.ai

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

### With Claude Code (CLI)

```bash
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](docs/Using%20PM%20Skills%20with%20Claude.md).

### 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](docs/Using%20PM%20Skills%20with%20Codex.md).

### With ChatGPT

Use GitHub app connections (formerly connectors), Custom GPT Knowledge uploads, or Project files. See [Using PM Skills with ChatGPT](docs/Using%20PM%20Skills%20with%20ChatGPT.md).

### 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](docs/Using%20PM%20Skills%20101.md)** — Beginner-friendly orientation for PMs who want clear setup without technical overload.
- **[Using PM Skills with Claude](docs/Using%20PM%20Skills%20with%20Claude.md)** — Claude Code usage plus GitHub ZIP upload steps for Claude Desktop/Web.
- **[Using PM Skills with Codex](docs/Using%20PM%20Skills%20with%20Codex.md)** — Local workspace usage plus GitHub-connected Codex on ChatGPT.
- **[Using PM Skills with ChatGPT](docs/Using%20PM%20Skills%20with%20ChatGPT.md)** — GitHub app connection, Custom GPT Knowledge setup, and Project-based usage.
- **[Platform Guides for PMs](docs/Platform%20Guides%20for%20PMs.md)** — 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](docs/Using%20PM%20Skills%20with%20Claude%20Code.md)** — PM-focused quickstart for Claude Code users.
- **[Using PM Skills with Slash Commands 101](docs/Using%20PM%20Skills%20with%20Slash%20Commands%20101.md)** — Turn PM skills into reusable Claude slash commands like `/pm-story` and `/pm-prd`.
- **[Using PM Skills with Claude Desktop](docs/Using%20PM%20Skills%20with%20Claude%20Desktop.md)** — Skill upload workflow for non-technical desktop users.
- **[Using PM Skills with ChatGPT Desktop](docs/Using%20PM%20Skills%20with%20ChatGPT%20Desktop.md)** — Project-first setup for desktop-based PM work.
- **[Using PM Skills with n8n](docs/Using%20PM%20Skills%20with%20n8n.md)** — Practical automation patterns for repeatable PM workflows.
- **[Using PM Skills with LangFlow](docs/Using%20PM%20Skills%20with%20LangFlow.md)** — Visual workflow setup using skill-guided prompt templates.
- **Additional harness guides:** [Cursor](docs/Using%20PM%20Skills%20with%20Cursor.md), [Windsurf](docs/Using%20PM%20Skills%20with%20Windsurf.md), [Bolt](docs/Using%20PM%20Skills%20with%20Bolt.md), [Replit Agent](docs/Using%20PM%20Skills%20with%20Replit%20Agent.md), [Make.com](docs/Using%20PM%20Skills%20with%20Make.com.md), [Devin](docs/Using%20PM%20Skills%20with%20Devin.md), [CrewAI](docs/Using%20PM%20Skills%20with%20CrewAI.md), [Gemini](docs/Using%20PM%20Skills%20with%20Gemini.md)
- **[Start Here](START_HERE.md)** — One-page "do this now" onboarding for skills and commands.
- **[Commands](commands/README.md)** — Command format, command list, validation, and discovery.
- **[Catalog Artifacts](catalog/README.md)** — Generated skill/command indexes for fast navigation.
- **[PM Skills Rule-of-Thumb Guide](docs/PM%20Skills%20Rule-of-Thumb%20Guide.md)** — Non-technical setup choices (local repo vs ZIP vs app connections) in plain English.
- **[Marketplace Strategy](MARKETPLACE_STRATEGY.md)** — PM-friendly strategy for distributing skills in marketplaces.
- **[Marketplace Submission Runbook](docs/Marketplace%20Submission%20Runbook.md)** — Step-by-step submission workflow for non-technical teams.
- **[Marketplace Issue Templates](docs/Marketplace%20Issue%20Templates.md)** — Reusable issue templates for marketplace execution and tracking.
- **[PM Tooling Operations Charter](docs/PM%20Tooling%20Operations%20Charter.md)** — Pedagogic operating stack across M365 Copilot, Codex, ChatGPT, VS Code/Copilot, Cursor, n8n, and Lovable.
- **[Add-a-Skill Utility Guide](docs/Add-a-Skill%20Utility%20Guide.md)** — End-to-end automation guide for generating and validating new skills.
- **[Building PM Skills](docs/Building%20PM%20Skills.md)** — 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`](skills/product-strategy-session/SKILL.md) (2-4 weeks, orchestrates positioning → roadmap)

### "I need to validate a customer problem before building"
→ **Workflow:** [`discovery-process`](skills/discovery-process/SKILL.md) (3-4 weeks, interviews → synthesis → validation)

### "I need to test a hypothesis quickly before investing in development"
→ **Interactive:** [`pol-probe-advisor`](skills/pol-probe-advisor/SKILL.md) (recommends which prototype type: Feasibility, Task-Focused, Narrative, Synthetic Data, or Vibe-Coded)
→ **Component:** [`pol-probe`](skills/pol-probe/SKILL.md) (template for documenting validation experiments)

### "I want to know if I'm using AI strategically or just for efficiency"
→ **Interactive:** [`ai-shaped-readiness-advisor`](skills/ai-shaped-readiness-advisor/SKILL.md) (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`](skills/context-engineering-advisor/SKILL.md) (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`](skills/prd-development/SKILL.md) (2-4 days, problem → solution → stories)

### "I need to create a Q2 roadmap"
→ **Workflow:** [`roadmap-planning`](skills/roadmap-planning/SKILL.md) (1-2 weeks, epics → prioritization → sequencing)

### "I need to choose a prioritization framework"
→ **Interactive:** [`prioritization-advisor`](skills/prioritization-advisor/SKILL.md) (asks questions, recommends RICE/ICE/Kano)

### "I need to split a large epic"
→ **Interactive:** [`epic-breakdown-advisor`](skills/epic-breakdown-advisor/SKILL.md) (Richard Lawrence's 9 patterns)

### "I need to write a user story"
→ **Component:** [`user-story`](skills/user-story/SKILL.md) (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](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.**

---

## 📖 Related Resources

- **[Product Manager Prompts](https://github.com/deanpeters/product-manager-prompts)** — Task-specific prompts for ChatGPT, Claude, Gemini
- **[Productside](https://productside.com)** — AI-powered product management training and consulting
- **[Dean's LinkedIn](https://linkedin.com/in/deanpeters)** — Essays on AI-amplified product work

---

## 📜 License

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

See [LICENSE](LICENSE) for full details.

---

## 📞 Questions?

- **GitHub Issues:** [Report bugs or suggest features](https://github.com/deanpeters/Product-Manager-Skills/issues)
- **LinkedIn:** [Connect with Dean Peters](https://linkedin.com/in/deanpeters)
- **Productside:** [Learn more about AI PM consulting](https://productside.com)

---

**v0.79 — May 15, 2026**

Highlights in this release:
- Added `organic-growth-advisor` interactive skill — McKinsey Growth Pyramid L2–L5 triage
- Added `pm-skill-creator` interactive skill for guided skill design
- Added configurable input length guard to `run-pm.sh` (env var `PM_MAX_INPUT`, default 4000)
- Added adapter name validation and path traversal protection to `add-a-skill.sh`
- Fixed missing `.claude-plugin/plugin.json` that blocked Claude Code skill discovery

**v0.78 — April 26, 2026**

Highlights in this release:
- Added one-command release packaging with `./scripts/build-release.sh`
- Added Claude Desktop/Web ZIP packs for starter, discovery, strategy, delivery, AI PM, and all-skills use cases
- Added a Codex ZIP that installs `.agents/skills` plus `AGENTS.md`
- Added GitHub Actions to validate, build, upload artifacts, and publish release assets on `v*` tags
- Added install docs for Claude Desktop/Web, Claude Code, Codex, and release maintainers
- Updated the README with a clearer Start Here path for people who just want to use the skills

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