New advertisers: 50% off your first month with code FIRSTMONTHSee slots

Decision-first survey design plugin that checks fit before drafting questions to limit bias.

GitHub stars
8.1K
View on GitHub

What it does

  • Covers the choice between a survey and other research methods, then the design of questions, response scales, and sampling
  • Guides question wording to avoid leading, double-barreled, and loaded phrasing before any survey is fielded
  • Designed for product and research teams deciding whether a survey will answer a question at all

Decide whether a survey is the right tool, then design one that avoids bias.

Add marketplace

/plugin marketplace add deanpeters/Product-Manager-Skills

Run it inside Claude Code once, then install the plugin below.

Install

/plugin install survey-design-advisor@pm-skills

Run it inside Claude Code after adding the marketplace.

Files

Discovered from source

Survey Design Advisor

Purpose

Decide whether a survey is the right way to learn what you want to know, and if it is, design one that produces answers you can use.

Surveys are cheap to send and easy to misuse. They are good at one thing: measuring how common something is, across a group you can reach, when you already know what to ask. They are poor at discovering why, finding problems you haven't thought of, or predicting what people will do. A survey answers the questions you wrote, in the words you chose, from the people who replied. All three are biased, and the data still looks like a number.

The sentence to keep in your head: use interviews to find out what to ask, and a survey to find out how many.

Input

Works best with: What you want to learn, from whom, and what decision the answer informs.

Also useful: The people you can reach and how (email list, in-app, partners), a draft survey, and prior research or usage data on the same question.

Anything supplied with the invocation itself (text after the skill name, a pasted context dump, or an appended ARGUMENTS: line) counts as answers already given. Use it and skip whatever it covers; don't re-ask.

Arriving empty-handed? That works too. The skill starts with the question you're trying to answer and what you'll do with the result, then walks the decision from there. If a survey is the wrong tool, it says so and points you to the right one.

Example invocations:

  • Should we survey customers about a routing add-on? We want to know if they'd pay.
  • Review this survey draft before I send it to 400 plant engineers.

Key Concepts

When a Survey Fits, and When It Doesn't

You want to...Best toolWhy
Find out why people behave a way, or what problems existInterviews (discovery-interview-prep)A survey can't follow up or notice what you didn't ask
See what people actually doUsage data (usage-data-investigation)Behavior beats stated behavior
Measure how common a known thing is across a groupSurveyThis is its job
Test willingness to payA priced test or a real commitmentStated intent overstates behavior
Compare known options on a defined scaleSurveyWith care for order effects

If the answer to "what will we do differently depending on the result?" is "nothing," don't send it.

Stated Is Not Done

What people say they'll do and what they do diverge, and surveys capture the first. "Would you use this?" gets yes from people who never will. Ask about past behavior ("When did you last rebuild your schedule by hand?") rather than future intent ("Would you use a tool that...?").

Bias Lives in Four Places

  • Question bias. Leading ("How much do you love..."), loaded, double-barreled (two questions in one), or full of jargon. Neutral wording, one idea per question.
  • Scale and order bias. Early options and positive anchors get picked more. Randomize options where order is meaningless, and use balanced scales.
  • Sample bias. The people who answer are the ones who like you, have time, or were reachable. A survey sent to your newsletter describes your newsletter.
  • Non-response bias. Silence is data: the busiest and the unhappiest often don't answer.

Sample: Who, and How Many

Define who you need to hear from before the question list. Then ask where they are and whether you can reach them. A small, well-chosen sample of the right people beats a large one of whoever replied. Say what the result can claim: "of the 140 plant engineers who responded from our partner lists" is honest; "the market" is not. Don't promise statistics a response count can't carry.

Length and Question Types

Short wins: every extra question loses people, and the last ones get rushed answers. Put the most important questions first, keep it under a few minutes, and use closed questions for measurement and one or two open questions for the things you didn't think to ask. A required open text box at the end is where the real finding often hides.

Test It Before You Send It

Have five people from the target group take it aloud and tell you what each question meant to them. Misread questions show up in five minutes and ruin a thousand responses.

Facilitation Source of Truth

Use workshop-facilitation as the interaction protocol: heads-up, one question per turn, numbered options, and best-guess mode on request.

Default entry mode: Guided · set in pm-skills.config.yaml (library-wide default or a per-skill override); the user's own choice in the session always wins. On the first turn, offer all three modes, then open in the default without waiting for a pick: Guided asks the first question, Context dump invites the paste, Best guess asks for a one-sentence minimum and drafts with every assumption labeled.

Anti-Patterns (what this is NOT)

  • Not a survey generator. It decides the method and shapes the design; the questions are yours to own.
  • Not a statistics tool. It won't compute significance on a thin response set.
  • Not a substitute for interviews. If you don't know what to ask, talk to people first.

Application

This skill asks up to 4 adaptive questions, then recommends a design (or a different method).

Question 1 of 4: What do you want to learn, and what will you do with it?

Agent asks:

"What do you want to find out, and what decision will the answer change?"

Listen for the method hidden in the question. "Why do customers churn?" is an interview question. "What share of accounts use feature X?" is usage data. "How many plants run aging controllers?" is a survey (or a purchased list). If no decision depends on it, say so and stop.

Question 2 of 4: Is this about how common, why, or what they'll do?

Agent asks:

"Which is closer to what you need?

  1. How common is something (how many, how often, which of these)
  2. Why something happens, or what problems exist (reasons, causes, unknowns)
  3. What people will do or pay (future behavior, willingness to pay)
  4. Not sure"

Route: 1 → survey fits. 2 → recommend interviews, and offer a short survey after to size what they found. 3 → warn that stated intent overstates behavior; recommend a priced or committed test (pol-probe-advisor) with a survey only as a supplement. 4 → help them name it.

Question 3 of 4: Who do you need to hear from, and can you reach them?

Agent asks:

"Who exactly should answer, and how will you reach them?

  1. Our own customers (email, in-app)
  2. Prospects or a market segment (a list, panel, or partner channel)
  3. People through partners or resellers
  4. I'm not sure who I need"

Use it to name the sampling bias (own customers = engaged customers; partners = partner-served) and what the results can and cannot claim. Ask how many they can realistically reach.

Question 4 of 4: How long and what shape?

Agent asks:

"How much of their time can you ask for, and do you already have a draft?"

Fit the design: under 3 minutes, 8-12 closed questions plus one open; most important first; neutral wording; past behavior, not future intent. If a draft exists, critique it first: quote each leading, loaded, or double-barreled question and say why.

Final Step: Recommend the design

## Survey Recommendation: [what you're learning]

**Verdict:** [Survey fits / Interviews first / Usage data first / Priced test instead]
**Why:** [one or two lines tied to their answers]

### If a survey: the design
- **Who:** [target and reach, and what the results can claim]
- **Questions:** [about N, closed vs open, order, past-behavior framing]
- **Bias controls:** [neutral wording, randomized options, balanced scales]
- **Sample and what it can't say:** [size realistic, non-response caveat]
- **Test first:** five people from the target group, read aloud

### Questions to fix (if a draft was supplied)
| Question | Problem | Rewrite (option to accept, adapt, or reject) |

### Next
1. [skill or action]
2. [skill or action]

Examples

Example A: SaaS, "would they pay?"

User: "We want to know if customers would pay for the Route Optimizer. Let's survey the base."

Agent (Q2): "Which is closer: how common something is, why it happens, or what people will do or pay?" → 3 (will pay).

Agent: "Stated willingness to pay overstates real behavior, and a survey to your own customers reaches your most engaged ones. A survey can tell you how many feel the rescheduling pain. It can't tell you they'll pay. Here's what I'd do:"

Verdict: Interviews first, then a priced test. Ask 6-8 dispatchers about the last time they rebuilt the day (past behavior). Then offer the add-on at a real price to a small group and count who signs up (pol-probe-advisor). If you still want a survey, use it to size the pain ("In the last two weeks, how many times did you rebuild the day by hand?"), not willingness to pay.

Example B: Industrial, "how many plants?"

User: "How many mid-size plants run controllers older than ten years? We need to size the retrofit market."

Agent (Q2): → 1 (how common). "A survey fits, with a caution about who you can reach."

Agent (Q3): "Partners reach plants they already serve, so the results describe partner-served plants, not the market." → 3 (through partners).

Verdict: Survey fits, scoped honestly. About 10 closed questions, controller age and count first, one open question on what stops replacement. Send through partners and say the result speaks to partner-served plants. Test with five maintenance engineers. Pair it with the market-sizing skill (tam-sam-som-calculator) rather than extrapolating.


Common Pitfalls

Pitfall 1: Surveying to Discover

Symptom: A survey sent to find out what problems exist. Consequence: You get answers to the questions you wrote and miss the ones you didn't. Fix: Interview first, then survey to measure what you found.

Pitfall 2: Asking About the Future

Symptom: "Would you use...?" "Would you pay...?" Consequence: Optimistic yeses that don't turn into behavior. Fix: Ask about past behavior, or test with a real commitment.

Pitfall 3: Leading and Double-Barreled Questions

Symptom: "How satisfied are you with our fast, reliable support?" Consequence: Two questions, one answer, and a nudge. Fix: One neutral idea per question.

Pitfall 4: Surveying Your Friends

Symptom: Sent to the newsletter or the most engaged customers. Consequence: The data describes your fans. Fix: Name the sample, and say what the result can't claim.

Pitfall 5: Claiming More Than the Sample Supports

Symptom: "The market wants X," from 60 replies. Consequence: A decision rests on a number that looks bigger than it is. Fix: Report counts, the reach, and the non-response.

Pitfall 6: No Test Run

Symptom: Sent without anyone reading it aloud first. Consequence: A thousand responses to a question nobody understood. Fix: Five people from the target group, read aloud.


References

Related Skills

External Frameworks

  • Past behavior over stated intent: Rob Fitzpatrick, The Mom Test.
  • Survey bias (question, order, sampling, non-response): standard survey methodology, for example Don Dillman, Internet, Phone, Mail, and Mixed-Mode Surveys.

Provenance

Distilled from practitioner experience designing and reviewing customer surveys for B2B and industrial products.

From the deanpeters/Product-Manager-Skills README

Product Manager Skills

Ready-made PM skills for your AI assistant. A skill is a short instruction file that teaches an AI how to do one PM job the way a pro would, such as writing a PRD or mapping stakeholders, so you stop re-explaining your process every time.

Try it in five minutes

  1. Download the starter pack and unzip it.
  2. In Claude, open Settings → Capabilities → Skills and upload one skill ZIP from inside the folder. Using Claude Code, Codex or something else? Jump to Get Started.
  3. Start a chat and paste this, swapping in your own details:
Which of these skills fits what's on my desk this week? Here's the situation: [one or two sentences].

You should see Claude name the skill it is using and start asking you questions. Arriving empty-handed is fine: the skills ask for what they need.


GitHub stars GitHub forks GitHub watchers Contributors PRs Welcome

Version Skills Last commit Claude Code Plugin

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

95 battle-tested PM frameworks, ready for Claude, Codex, ChatGPT, and any agent that can read structured knowledge.


Why This Exists

Generic AI output is a PM's worst enemy. When you tell your agent "write a PRD" without shared context, you get a generic document that no stakeholder trusts and no engineer can act on.

This library gives both you and your AI agent the same professional foundation: the why behind each framework, the failure modes to avoid, and the judgment to apply them correctly. You stop repeating yourself. Your agent stops guessing. The work gets better.

The goal is dual — functional and pedagogic in equal measure. Skills equip agents to do PM work at a professional level, and they teach the human PM the reasoning behind each framework — so you can explain it, adapt it, and pass it on. Neither is a byproduct of the other.


Get Started

Choose your setup:

I use...Get thisNotes
Claude Desktop or Claude Webpm-skills-starter-pack.zipUnzip, then upload the individual skill ZIPs to Claude Skills
Claude CodePlugin marketplace/plugin marketplace add deanpeters/Product-Manager-Skills, then /plugin install product-manager-skills@pm-skills for everything, or one lifecycle bundle at a time (see Browse by lifecycle)
Codexpm-skills-codex.zipInstalls .agents/skills and AGENTS.md
OpenCodeCopy skills/* to ~/.config/opencode/skills/ (or reuse the Codex ZIP)OpenCode reads our SKILL.md format as-is. See the install guide
Not surepm-skills-starter-pack.zipStart here

All downloads: GitHub Releases

Start here by situation

Don't know where to begin? Find the line that sounds like your week. Each route is a suggested order, not a pipeline — every skill runs on its own, so skip ahead, reorder, or stop after one. The first prompt is real: paste it, swap in your details, and go.

If this is you...Try, in this orderTimePaste this first
"I have an idea and I don't know if it's real."problem-framing-canvas → discovery-interview-prep → pol-probe-advisor~1–1.5 hrFrame this problem: field sales reps 'don't use the CRM' and leadership wants gamification.
"A request or mandate just landed on my desk."incoming-request-advisor → stakeholder-mapping → prioritization-advisor~1 hrMy VP DM'd me: "Any chance the dashboard redesign lands next sprint? Board's asking." Analyze this before I reply.
"I need to understand the market, fast."market-landscape-scan → competitive-research-snapshot → swot-analysis~1–2 hrRun a market landscape scan on [your market], and tell me the decision it should support.
"We keep getting compared and losing."positioning-workshop → roadmap-planning (going bigger: product-strategy-session, a 2–4 week workflow)~2–3 hrRun a positioning workshop for our API monitoring tool — we keep getting compared to Datadog and losing.
"Time to write it down."prd-development → epic-breakdown-advisor → user-story~1.5–3 hrBuild a PRD for self-serve workspace provisioning — here are my discovery notes and the OKR it ladders to.
"Our product is getting old."lifecycle-play-advisor → eol-readiness-advisor → eol-process~30–50 min to a decisionHelp me decide what to do with [product]. Here's what makes me think it's fading: [signals].
"I'm stepping up a level."director-readiness-advisor or vp-cpo-readiness-advisor — pick by where you're headed~10–20 minI'm 60 days into a Director role and my old peers now report to me — it's awkward and I'm still doing PM work. Coach me.
"I'm new here, or not sure."The Starter pack — six skills across the craft—Install it, then ask: Which of these skills fits what's on my desk this week?

Why these orders (so you can break them on purpose):

  • Idea → problem → people → probe. Name the problem before you ask anyone about it, and ask people before you build anything. The probe comes last because it's the most expensive of the three.
  • Request → decode → map → decide. Understand what's really being asked before replying, know who else is in the room, then ask where it fits. Prioritizing first is how a loud VP becomes your roadmap.
  • Market → competitors → SWOT. Evidence first, framework last. SWOT on top of no research is opinion with a 2×2 around it.
  • Positioning → roadmap. Decide who you're for and why you win before choosing what to build. The strategy session is the full-length version when the question is bigger than a quarter.
  • PRD → epics → stories. The why first, then slices, then the smallest writeable pieces. Writing stories first is how a backlog loses its reason.
  • Aging → play → readiness → process. The first skill may say "nothing yet" — extending or harvesting is a legitimate answer, and starting here does not commit you to a sunset.

Browse by lifecycle

Product work unfolds in an order: set the outcome before you investigate, investigate before you define, define before you build. The library follows that arc in five bundles, with a sixth that runs underneath all of them. It's a cycle, not a pipeline, so you will loop back, and every skill still runs on its own.

BundleThe question it answersStart withClaude Code install
DetermineWhat are we trying to achieve, and what is the market doing?product-strategy-session, market-landscape-scan, business-health-diagnostic/plugin install pm-determine@pm-skills
DiscoverWhat is the real problem?problem-framing-canvas, discovery-interview-prep/plugin install pm-discover@pm-skills
DefineIs this solution worth building, and how do we position it?pol-probe-advisor, positioning-statement/plugin install pm-define@pm-skills
DevelopHow do we turn the chosen solution into buildable work?prd-development, user-story, prioritization-advisor/plugin install pm-develop@pm-skills
DeliverHow do we price it, take it to market, and retire it well?finance-based-pricing-advisor, lifecycle-play-advisor/plugin install pm-deliver@pm-skills
DriveHow do I work with stakeholders and grow my career?stakeholder-mapping, director-readiness-advisor/plugin install pm-drive@pm-skills

Not sure which bundle? Ask the pm-skills-navigator: describe what's on your desk, and in about five minutes it tells you where the work really is and which skill to open first.

Every bundle includes a few shared helper skills (the facilitation rulebook and the navigator among them), so each works installed alone. The full list, grouped by bundle and by the smaller "motions" inside each, is in catalog/skills-by-bundle.md.

Why this order? Skipping ahead is how teams build the right thing for the wrong problem. Naming the outcome first gives discovery a target, and discovery gives definition something real to test.

On Claude Desktop or Web? Download the bundle pack that matches your phase, or grab single skills from the download shelf.

Lifecycle bundle packs for Claude Desktop / Web

Each pack is a ZIP of upload-ready skill ZIPs. Unzip it, then upload the skills to Claude Skills:

PackDownloadWhat's inside
Starterpm-skills-starter-pack.zipSix core skills across the craft. The best first download
Determinepm-determine-pack.zipStrategy, finance, market intelligence, customer context (24 skills)
Discoverpm-discover-pack.zipInterviews, surveys, usage data, synthesis, assumptions, problem framing, opportunity trees, journey maps (12 skills)
Definepm-define-pack.zipHypotheses, probes, experiments, positioning (9 skills)
Developpm-develop-pack.zipPRDs, stories, prioritization, roadmaps, sprint and release rituals, AI agents (16 skills)
Deliverpm-deliver-pack.zipLaunch plans, messaging, sales enablement, pricing, channels, post-launch metrics, activation and retention, and the end-of-life suite (18 skills)
Drivepm-drive-pack.zipStakeholders, decision rights, influence, and career transitions (11 skills)
All skills99-all-skills-pack.zipAll 95 skills

The older themed packs (02-discovery through 07-lifecycle-eol) were retired in v0.86. Every skill in them lives in a lifecycle pack above.

Install guides


Try It First — Streamlit (beta)

Not ready to wire skills into your agent setup? Run the local playground first and kick the tires in your browser.

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

What you can do:

  • Learn — browse setup and integration paths without leaving the app
  • Find My Skill — describe your situation in plain English and get recommended skills
  • Run Skills — run a skill with your own scenario once you know what you want

Multi-provider support: Anthropic, OpenAI, Ollama. API keys via environment variables only (no in-app key entry).

Docs: app/STREAMLIT_INTERFACE.md · app/.env.example

Feedback welcome via GitHub Issues or LinkedIn.


What You Can Get Done

Navigate by what you're actually trying to accomplish:

Framing and strategy

  • problem-framing-canvas — MITRE's Look Inward / Look Outward / Reframe sequence; stops teams from solving the wrong problem
  • positioning-statement — Geoffrey Moore's template for defining who you serve, what you solve, and how you're different
  • product-strategy-session — full strategy arc: positioning → problem framing → solution exploration → roadmap (2-4 weeks)

Stakeholder alignment

  • stakeholder-identification — map every stakeholder before engaging anyone: broad brainstorm → allies/audiences/influencers → R/P/D marking → equity lens → narrow to priority targets
  • stakeholder-mapping — run two complementary grids (Power × Interest for engagement strategy; Impact × Power for whose voice to elevate) and compare to find the gaps
  • stakeholder-engagement-advisor — per-stakeholder engagement planning: diagnoses their profile and context, then delivers tailored message framing, medium, cadence, and a named next action

Customer discovery and research

Prioritization and roadmapping

  • prioritization-advisor — asks 3-5 questions about your context, then recommends RICE, ICE, Kano, or the right alternative
  • epic-breakdown-advisor — splits large epics using Richard Lawrence's 9 patterns
  • roadmap-planning — gather inputs → define epics → prioritize → sequence → communicate (1-2 weeks)

Writing PM deliverables

  • user-story — Mike Cohn format + Gherkin acceptance criteria, with anti-patterns
  • prd-development — structured PRD: problem → personas → solution → metrics → stories (2-4 days)
  • press-release — Amazon Working Backwards: clarify product vision before writing a line of spec

Validation and experimentation

  • pol-probe-advisor — recommends which prototype type to run based on your hypothesis and risk level
  • pol-probe — template for documenting lightweight validation experiments before building

Finance and growth

  • business-health-diagnostic — diagnoses SaaS health across growth, retention, efficiency, and capital using your real metrics
  • organic-growth-advisor — McKinsey Growth Pyramid triage: diagnoses whether your constraint is in new segments, geographies, channels, or products
  • feature-investment-advisor — build / don't build recommendation using revenue impact, cost, ROI, and strategic value

Market and competitive intelligence

Aging products: extend, replace, or retire

  • lifecycle-play-advisor — start here when a product stops growing: seven transition questions establish the stage, then it picks the play — extend, replace, or retire — and tells you when the honest answer is "nothing yet"
  • product-lifecycle-plays — the framework behind that call: the PLC strategy grid, the seven replacement hazards, and a risk register whose last column asks what is Plan B?
  • eol-process — the whole sunset in six phases, decide → align → plan → prepare → announce → close, including the post-EOL review everyone skips
  • The EOL chain: eol-readiness-advisor → eol-stakeholder-sequence → eol-checklist → eol-internal-enablement → eol-message — every one runs standalone, sized Light/Standard/Heavy by you

Career and leadership transitions

AI product work


95 Skills, 3 Types

Skills are organized in three tiers that build on each other:

┌────────────────────────────────────────────────────────┐
│  WORKFLOW SKILLS (25)                                  │
│  Complete end-to-end PM processes (days to weeks)      │
│  Example: run a full discovery cycle or write a PRD    │
└────────────────────────────────────────────────────────┘
                       ↓ orchestrates
┌────────────────────────────────────────────────────────┐
│  INTERACTIVE SKILLS (34)                               │
│  Guided discovery — 3-5 questions, then recommendations│
│  Example: "Which prioritization framework fits here?"  │
└────────────────────────────────────────────────────────┘
                       ↓ uses
┌────────────────────────────────────────────────────────┐
│  COMPONENT SKILLS (36)                                 │
│  Templates for specific PM deliverables (30-90 min)    │
│  Example: write a user story with acceptance criteria  │
└────────────────────────────────────────────────────────┘

Interactive skills use an Adaptive Decision Ladder. Instead of dumping a framework at you, an interactive skill asks 3-5 targeted questions about your specific context, then offers numbered recommendations — each with a clear "use this when" rationale. You pick a path. The skill executes it and explains the why as it goes. If you want to just learn the framework without doing the work, you can ask that too — the skill coaches you either way. This is ABC — Always Be Coaching — in practice.

Full catalog: by type or by lifecycle bundle, all 95 skills with descriptions, or browse skills/ directly.


How a Skill File Works

Every SKILL.md follows the same structure:

SectionWhat it contains
Frontmattername, description, type, intent, best_for, scenarios
PurposeWhat this skill does and when to reach for it
InputWhat you can bring (with example invocations) — inline input is used, not re-asked, and arriving empty-handed is fine: the skill walks you through it
Key ConceptsFrameworks, definitions, anti-patterns — with vocabulary explained
ApplicationStep-by-step instructions an agent (or human) can follow
ExamplesReal-world cases showing both good and bad versions
Common PitfallsNamed failure modes with consequences and corrections
ReferencesRelated skills and external frameworks

The best_for frontmatter field lists 3-5 specific scenarios where the skill is most useful — helpful for quickly scanning whether a skill fits your situation.

Why no $ARGUMENTS templating? Other skill libraries use Claude Code's $ARGUMENTS substitution for input. We deliberately don't: it only expands in Claude Code (it renders as literal syntax in Claude Desktop/Web, Codex, and the Streamlit playground), and it teaches the human reader nothing. Instead, every skill has a plain-language ## Input section that works on every runtime — and makes clear you can show up with full context, partial context, or nothing at all and be guided through the rest. Full rationale in CONTRIBUTING.md.

Guided Context Capture. Every interactive skill gathers context the same way. You can go one question at a time, paste what you know, or say "best guess." A pasted dump gets read back to you as Known / Assumed / Missing / Conflicting before any question is asked. You get a recap before anything is generated. Decisions come as a ranked ladder (Recommended first, real alternatives with tradeoffs), and you make the call. The skill never re-asks what you already said or passes a guess off as a fact. Guided is the default opening; change it library-wide or per skill in pm-skills.config.yaml. How it works and why: docs/guided-context-capture.md.


Works With

Claude Code · Claude Desktop · Claude Web · OpenAI Codex · ChatGPT · Cursor · Windsurf · n8n · LangFlow · CrewAI · Gemini · OpenCode · any agent that reads structured markdown

See docs/Platform Guides for PMs.md for platform-specific setup.


Docs

DocumentPurpose
Using PM Skills 101Beginner-friendly orientation — setup without technical overload
Platform Guides for PMsTool-by-tool setup chooser for every supported platform
Using PM Skills with ClaudeClaude Code + GitHub ZIP upload for Claude Desktop/Web
Using PM Skills with CodexLocal workspace + GitHub-connected Codex on ChatGPT
Using PM Skills with ChatGPTGitHub app, Custom GPT Knowledge, and Project-based usage
Using PM Skills with Slash Commands 101Turn skills into reusable slash commands like /pm-story
Add-a-Skill Utility GuideEnd-to-end guide for generating and validating new skills
Market Intelligence Suite SummaryThe 14-skill competitive/market research suite: disciplines, chain, and which skill to run when
Lifecycle & EOL Suite SummaryThe 8-skill lifecycle/sunset suite: the three plays, the EOL chain, and right-sizing
Building PM SkillsHow raw PM content gets distilled into agent-ready skills
START_HERE.md60-second onboarding for local repo users

What's New

v0.86 — November 13, 2026 · The Everyday Work of Product, Now on the Map

v0.85 — November 13, 2026 · Lifecycle Bundles, a Navigator, and the Go-to-Market Gap Filled

v0.84 — August 10, 2026 · The Lifecycle & End-of-Life Suite

  • 7 new skills + 1 upgrade for the part of product management nobody trains you on: what to do with a product that has stopped growing, and how to retire one without losing the customer
  • Start upstream of the kill decision. lifecycle-play-advisor and product-lifecycle-plays diagnose where a product actually sits using seven transition questions, then pick between the three plays — extend, replace, or retire. Includes the seven replacement hazards and a risk register whose contingency column asks the question everyone skips: what is Plan B?
  • The EOL chain: eol-readiness-advisor (go/no-go, and it will tell you to hold) → eol-stakeholder-sequence (Legal before Finance before Sales — get the order wrong and you find the landmines after the announcement) → eol-checklist (phase-gated, an owner on every item) → eol-internal-enablement (your teams ready before customers hear) → eol-message (upgraded: three transition paths including the honest no-replacement case) → eol-process (the whole thing, six phases, including the post-EOL review everybody skips)
  • Right-sizing is a dial you set, not a verdict handed to you. Every skill offers Light / Standard / Heavy, defaults to Standard, and names what a lighter choice leaves uncovered. A feature deprecation should never get a flagship playbook — that's how teams learn to ignore EOL process on the sunset that actually matters
  • No tight coupling. Every skill runs standalone; the workflow is a recommended route through independent stops, not a pipeline. Enter wherever you actually are — including mid-sunset, with a diagnostic that maps symptoms ("Support is drowning") to the phase that got skipped
  • Library now at 77 skills · full story in the release note

v0.83 — July 17, 2026 · The Market Intelligence Suite

v0.82 — July 8, 2026

  • Added incoming-request-advisor (Interactive) — drop in a Slack ping, email, mandate, or escalation and get a structured breakdown that separates the literal ask from the real job-to-be-done, reads sender power and stake, and points you toward a reply. Ships with a copy/paste template so you can run it by hand too
  • New: a browsable download shelf at /dist — no terminal, no Releases tab. Read the plain-language README, scan the CATALOG, and download any skill or pack straight from the repo. Built for PMs who just want the skills
  • Library now at 56 skills

v0.81 — July 4, 2026

  • Every skill now has a required ## Input section: what to bring, what happens to context you supply up front (it's used, not re-asked), and reassurance that arriving empty-handed is fine — the guided flow covers the rest
  • Added argument-hint autocomplete for Claude Code users; deliberately no $ARGUMENTS templating — it breaks on every other runtime and teaches the reader nothing (why)
  • Validator now enforces the convention: skills fail without an Input section or with bare $ARGUMENTS in the body
  • Streamlit playground shows each skill's "What to bring (all optional)" before you start a session
  • Restored agent-orchestration-advisor (Interactive) — the multi-agent workflow design skill was referenced everywhere but only existed on an orphaned commit; recovered from git history and brought up to current standards

v0.80 — June 19, 2026

  • Added stakeholder-identification (Component) — comprehensive stakeholder brainstorm using allies/audiences/influencers, R/P/D marking, equity lens, and bias check; narrows to priority targets
  • Added stakeholder-mapping (Component) — two complementary grids (Power × Interest + Impact × Power); comparing outputs reveals who you're under-engaging relative to how much the product affects them
  • Added stakeholder-engagement-advisor (Interactive) — per-stakeholder engagement planning via Adaptive Decision Ladder: three questions on profile, power/impact, and context deliver tailored message framing, medium, cadence, and a named next action

All three adapted from the MITRE Innovation Toolkit via the companion repo MITRE ITK Skills — worth a bookmark if you work in discovery, facilitation, or cross-functional product strategy.

v0.79 — May 15, 2026

  • Added organic-growth-advisor — McKinsey Growth Pyramid triage for new segments, geographies, channels, or products
  • Added pm-skill-creator — interactive skill for designing repo-compliant skills via guided conversation
  • Fixed missing .claude-plugin/plugin.json that silently blocked Claude Code skill discovery
  • Added configurable input length guard (PM_MAX_INPUT) and path traversal protection to helper scripts

→ Full changelog


Contributing

Found a gap? Have a PM framework worth formalizing? The bar is pedagogic — skills must teach the why, not just the how.

See CONTRIBUTING.md for guidelines, or open an issue to start a conversation.


License

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

Everything in this repository — every skill, template, and doc — is licensed CC BY-NC-SA 4.0. There is no mix of licenses here.

Some skills note in their Provenance sections that they were adapted from product-manager-prompts, Dean's earlier prompt library. That repo has the same author, so there is no license conflict: a license grants permissions to other people, and a copyright holder is free to adapt and relicense their own work. Those Provenance lines are lineage — a breadcrumb back to where an idea started — not a license dependency. No third-party MIT-licensed text is incorporated anywhere in this library.

In plain terms:

  • ✅ Use these skills in your day job — at a for-profit company, with your team, in your agents. That's what they're for.
  • ✅ Adapt and remix them — share what you build under this same license, with credit.
  • ✅ Teach with them — workshops, brown bags, mentoring, sending the ladder down.
  • ❌ Don't sell them — no repackaging the skills themselves into a paid product, course, or service without expressed written permission.
  • 📄 Need something citable for your legal team? See LICENSING.md: internal use at a for-profit company is fine, and what you produce using the skills is yours.
  • 🤔 Not sure your use qualifies? Open an issue and ask. If you're using these in the spirit they were built — to get better at the craft and help others do the same — the answer is almost certainly yes.

The companion prompt library, product-manager-prompts, carries the same CC BY-NC-SA 4.0 license as of its v2.3.0, with its own plain-language permissions (stricter on commercial use) — see its LICENSING.md, which governs that repo.


Questions

Details

Marketplace
deanpeters/Product-Manager-Skills
Source
skills/survey-design-advisor
Category
Discovery

More from deanpeters/Product-Manager-Skills

All 102

Similar to survey-design-advisor

More Design & Creative