
message-house
Message house plugin that structures product messaging around one roof message, value pillars, and sourced proof.
- GitHub stars
- 8.1K
What it does
- Builds a message house with one roof message, value pillars, and proof points for each pillar
- Covers role and channel variants so the same core message can be adapted for different audiences and channels
- Requires each proof point to cite a source, keeping claims tied to evidence rather than assertion
- Designed for product managers and marketers who need consistent positioning across launches and campaigns
Build a message house: one roof message, value pillars, sourced proof, and role and channel variants.
Add marketplace
/plugin marketplace add deanpeters/Product-Manager-SkillsRun it inside Claude Code once, then install the plugin below.
Install
/plugin install message-house@pm-skillsRun it inside Claude Code after adding the marketplace.
Files
Discovered from sourceMessage House
Purpose
Build a message house: the one thing you want customers to remember (the roof), the value themes that hold it up (the pillars), the proof under each theme, the credibility facts the whole house stands on (the foundation), plus variants by buying-group role and channel, words to use and avoid, and a plan to test it with real customers.
It sits between strategy (positioning, jobs, pains and gains) and the material people actually use (web page, deck, brochure, partner kit). It is the source copywriters write from, not the final copy. The failure it prevents: a message house whose pillars are three features, so customers hear a spec sheet and nobody sees why it matters.
Input
Works best with: The offering, the target customer, and your positioning statement if you have one.
Also useful: The customer's top pains and gains (from interviews or jobs-to-be-done),
proof you already hold (tests, references, measured results), your current messaging, and the
channels you speak through.
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 asks who the customer is and what they are
trying to get done, drafts pillars as labeled hypotheses, and leaves every proof point as a
[NEEDS SOURCE] blank. It will not invent a customer, a quote, or a number.
Example invocations:
Message house for the Route Optimizer. Positioning: for dispatchers at 50-300 tech field service companies...Review these three pillars: variable speed drive, IoT connectivity, compact design.
Key Concepts
What a Message House Is
| Part | Holds | Test |
|---|---|---|
| Roof | One umbrella value message | Can a customer repeat it after one reading? Is it value, not a feature? |
| Pillars (about three) | Value themes, each tied to a top customer pain or gain | Does each name an outcome the customer cares about? Are the three distinct? |
| Proof points (under each pillar) | Evidence: tests, references, measured results, a calculation the customer can repeat | Is each sourced, or flagged [NEEDS SOURCE]? |
| Foundation | Facts that make any claim believable: time in market, installed base or customer count, service network, certifications, security attestations | True today and verifiable? Facts, not adjectives? |
Three pillars is a habit, not a law. Two strong pillars beat four weak ones. More than four and nobody remembers any.
Start From the Customer, Not the Spec Sheet
Pillars come from the customer's side: the jobs, the top pains, and the top gains, where the offering is also genuinely strong. The pillar names the outcome; the features are the reason it's true.
| Feature pillar (drift) | Value pillar |
|---|---|
| Variable speed drive | Pay for the air you use, not the air you waste |
| Real-time GPS and routing engine | Fit the emergency job in without wrecking the day |
| Compact design | Fits the cabinet you already have |
The cover test: cover the product name. If a competitor's data sheet could produce the same pillar, it's a feature posing as a pillar.
Link to Positioning and to Jobs, Pains, and Gains
The roof must agree with the positioning-statement: same
target, same category, same main benefit. Each pillar should trace to a specific pain or gain, and
each proof point to evidence. Keep the trace visible in the artifact so anyone who later changes a
message can see what it rests on.
Proof: Sourced or Flagged
Proof turns a claim into a reason to believe. Strongest first: independent test or certification; a named customer reference with written permission; a measured result from a pilot or installed base; an internal test with the method available; a calculation the customer can repeat with their own numbers. An unsupported claim is not proof. A pillar with no proof is a hypothesis and stays out of external material until the proof exists.
Superlatives Need Proof Too
"Leading," "best-in-class," "most efficient," "unique," "first": each is a claim of fact. Technical buyers discount them, and unverifiable comparative claims carry legal risk. Use one only when you can name the basis (tested by whom, against what, under which standard) and Legal has cleared it. Otherwise say the specific thing: "cuts dispatcher rescheduling time by [X]%, measured across 14 pilot accounts" beats "the smartest scheduler" if the pilot exists, and if it doesn't, neither belongs in the house.
Variants by Role and by Channel
The roof and pillars stay the same. Emphasis and words change.
- By role. The day-to-day user hears the pillar as daily work; the technical evaluator as integration, reliability, and security; procurement as total cost and supplier risk; finance as payback; the sponsor as the outcome they own. A variant reorders and rewords pillars and picks the proof that role trusts. It never adds a new pillar for one role.
- By channel. Partners and resellers need short messages they can carry beside many brands, plus why this is good for their business. Integrators need technical proof. The web and events need a headline and one proof each. Support and service need words they can use on a call or on site.
Words to Use, Words to Avoid
A short shared vocabulary keeps the house consistent. Use: the customer's own words for their pains and gains, taken from interviews, sales calls, and support tickets. Avoid: internal jargon, unproven superlatives, and terms the customer doesn't use. Mark words from real customers as such.
Test With Real Customers
A message house is a hypothesis until customers react to it. Plan the test: which messages, which customers (five to eight from the target segment), how (read the roof and pillars aloud and ask what they heard, what they believe, and what they doubt), and what result changes the house. Record what customers repeat back, not whether they said they liked it.
Facilitation Source of Truth
Use workshop-facilitation as the interaction protocol when
running this conversationally.
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 positioning. Positioning is the internal strategic anchor. The house turns it into customer language.
- Not the sales story. The narrative, objections, and battle cards live in
sales-value-narrative. - Not copywriting. It's the source copywriters write from, not the ad or web page.
- Not a source of proof. It organizes proof you have and flags proof you need.
Application
Use template.md for the scaffold.
Output convention. Artifact first: scope, roof, pillars with their trace to pains and gains,
proof under each, foundation, role variants, channel variants, words to use and avoid, test plan.
Commentary short, after. Two stages: a working draft where every line carries a provenance tag
([FROM YOU], [RESEARCH], [AI-SUGGESTED, VALIDATE THIS]) and every unsupported proof point is
[NEEDS SOURCE] with the type of proof needed; then a committed copy with tags removed,
followed by a ranked Proof to Gather list and a Messages to Test list.
If the PM brings a draft, critique first. Is the roof one idea, in customer language, and consistent with positioning? Apply the cover test to each pillar. Does each pillar trace to a specific pain or gain? Quote every unsupported claim and every superlative. Is the foundation facts or adjectives? Do variants keep the same pillars? Has any of it been tested? Name gaps; offer rewrites last.
Step 1: Confirm Scope
The offering, the target customer, the positioning (or note its absence), the roles in the buying group, the channels. Ask what is software, what is physical, what is service, so the foundation and proof fit the real offering.
Step 2: Gather the Customer's Pains and Gains
From interviews, jobs work, support tickets, win/loss notes. Pick the few that matter most to the customer and where you are genuinely strong. Anything you draft yourself is a hypothesis.
Step 3: Draft the Roof, Pillars, and Trace
Roof first (one idea). Then pillars as outcomes, each with the pain or gain it traces to. Run the cover test on each.
Step 4: Attach Proof and Build the Foundation
Proof under each pillar, ranked by strength, sourced or flagged. Foundation as verifiable facts. Flag every superlative for proof and Legal review.
Step 5: Write Variants and Vocabulary
One variant per role that matters and per channel in use, same pillars. Words to use (with their source) and words to avoid.
Step 6: Plan the Test and Hand Back
Who to test with, what to ask, and what result changes the house. Close with a short summary
(supplied, inferred, unknown) and a numbered ladder, evidence-favored first, labeled
(Recommended): gather the missing proof; test the roof with five customers; reconcile existing
assets to the house; or build the sales narrative on top.
Examples
See examples/sample.md (Fieldlight Route Optimizer, SaaS) and
examples/sample-industrial.md (Northfield NFA-500, hardware).
Both show a feature-pillar draft rebuilt as value pillars.
Common Pitfalls
Pitfall 1: Feature Pillars
Symptom: Pillars read like a data sheet: speed, connectivity, size. Consequence: Customers hear specs, not reasons to care. Fix: Name the outcome the customer gets. Apply the cover test.
Pitfall 2: Pillars With No Trace
Symptom: Nobody can say which customer pain a pillar answers. Consequence: The house reflects what the company likes about itself. Fix: Record the pain or gain behind each pillar and where it was heard.
Pitfall 3: Unproven Superlatives
Symptom: "Best-in-class," "most reliable," "the only." Consequence: Technical buyers discount you; legal risk follows. Fix: Name the basis and clear it with Legal, or say the specific measured thing.
Pitfall 4: A New Message for Every Role
Symptom: Each role gets its own pillars. Consequence: The market hears five stories and the roof means nothing. Fix: Same pillars, different emphasis and proof.
Pitfall 5: The Foundation Is Adjectives
Symptom: "Trusted," "innovative," "world-class." Consequence: Nothing for the customer to verify. Fix: Years, counts, certifications, attestations, coverage, each true today.
Pitfall 6: Untested Messaging
Symptom: The house was approved internally and shipped. Consequence: It may persuade the room that wrote it and no one else. Fix: Test with five to eight target customers and record what they repeat back.
Pitfall 7: Invented Proof
Symptom: An AI-drafted house arrives with confident percentages, quotes, and customer names.
Consequence: One false claim repeated to a technical buyer loses the deal and the credibility.
Fix: Every proof point is sourced or [NEEDS SOURCE]. Never invent a customer or a number.
References
Skill Files
template.md: the house, trace, proof, variants, vocabulary, test planexamples/sample.md,examples/sample-industrial.md
Related Skills
positioning-statement: upstream; the roof must agree with itpositioning-workshop: upstream; the facilitated versionjobs-to-be-doneandproto-persona: upstream; the pains and gains pillars rest onsales-value-narrative: downstream; the sales story built on the pillarslaunch-plan: the plan's marketing rows draw on the houseworkshop-facilitation: interaction protocol
External Frameworks
- Message house: a widely used communications structure (roof, pillars, foundation) with no single originator.
- Jobs, pains, gains: Alexander Osterwalder et al., Value Proposition Design.
Provenance
Distilled from practitioner experience building value messaging for B2B and industrial offerings.
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
- Download the starter pack and unzip it.
- 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.
- 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.
╔════════════════════════════════════════════════════════════════════╗
║ ║
║ ██████╗ ███╗ ███╗ ███████╗██╗ ██╗██╗██╗ ██╗ ███████╗
║ ██╔══██╗████╗ ████║ ██╔════╝██║ ██╔╝██║██║ ██║ ██╔════╝
║ ██████╔╝██╔████╔██║ ███████╗█████╔╝ ██║██║ ██║ ███████╗
║ ██╔═══╝ ██║╚██╔╝██║ ╚════██║██╔═██╗ ██║██║ ██║ ╚════██║
║ ██║ ██║ ╚═╝ ██║ ███████║██║ ██╗██║███████╗███████╗███████║
║ ╚═╝ ╚═╝ ╚═╝ ╚══════╝╚═╝ ╚═╝╚═╝╚══════╝╚══════╝╚══════╝
║ ║
║ 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 this | Notes |
|---|---|---|
| Claude Desktop or Claude Web | pm-skills-starter-pack.zip | Unzip, then upload the individual skill ZIPs to Claude Skills |
| Claude Code | Plugin 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) |
| Codex | pm-skills-codex.zip | Installs .agents/skills and AGENTS.md |
| OpenCode | Copy skills/* to ~/.config/opencode/skills/ (or reuse the Codex ZIP) | OpenCode reads our SKILL.md format as-is. See the install guide |
| Not sure | pm-skills-starter-pack.zip | Start 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 order | Time | Paste 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 hr | Frame 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 hr | My 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 hr | Run 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 hr | Run 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 hr | Build 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 decision | Help 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 min | I'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.
| Bundle | The question it answers | Start with | Claude Code install |
|---|---|---|---|
| Determine | What 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 |
| Discover | What is the real problem? | problem-framing-canvas, discovery-interview-prep | /plugin install pm-discover@pm-skills |
| Define | Is this solution worth building, and how do we position it? | pol-probe-advisor, positioning-statement | /plugin install pm-define@pm-skills |
| Develop | How do we turn the chosen solution into buildable work? | prd-development, user-story, prioritization-advisor | /plugin install pm-develop@pm-skills |
| Deliver | How 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 |
| Drive | How 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:
| Pack | Download | What's inside |
|---|---|---|
| Starter | pm-skills-starter-pack.zip | Six core skills across the craft. The best first download |
| Determine | pm-determine-pack.zip | Strategy, finance, market intelligence, customer context (24 skills) |
| Discover | pm-discover-pack.zip | Interviews, surveys, usage data, synthesis, assumptions, problem framing, opportunity trees, journey maps (12 skills) |
| Define | pm-define-pack.zip | Hypotheses, probes, experiments, positioning (9 skills) |
| Develop | pm-develop-pack.zip | PRDs, stories, prioritization, roadmaps, sprint and release rituals, AI agents (16 skills) |
| Deliver | pm-deliver-pack.zip | Launch plans, messaging, sales enablement, pricing, channels, post-launch metrics, activation and retention, and the end-of-life suite (18 skills) |
| Drive | pm-drive-pack.zip | Stakeholders, decision rights, influence, and career transitions (11 skills) |
| All skills | 99-all-skills-pack.zip | All 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
- discovery-interview-prep — plans Mom Test-style interviews based on your research goals
- opportunity-solution-tree — generates opportunities and solutions, then recommends the best proof-of-concept to test first
- discovery-process — complete discovery cycle: frame → research → synthesize → validate (3-4 weeks)
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
- intel-discipline-advisor — start here: triages the question on your desk into the right intelligence disciplines, cadence, and executing skill
- competitive-analysis-process — the six-step umbrella: landscape → product comparison → customer needs → business baseline → positioning → strategic direction
- The investigation chain: market-landscape-scan → competitive-research-snapshot → competitive-intel-watch → battle-card-builder — each consumes the prior's schema, so research becomes a cadence instead of a one-off deck
- tam-sam-som-calculator — market sizing three ways: your own numbers, guided interview, or autonomous bottom-up research a skeptical CFO can attack one assumption at a time
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
- director-readiness-advisor — coaches PMs through the PM→Director shift across four situations: preparing, interviewing, newly landed, recalibrating
- vp-cpo-readiness-advisor — coaches Directors through VP/CPO transition, including a CEO interview framework for evaluating roles before you accept
- executive-onboarding-playbook — 30-60-90 day diagnostic playbook for VP/CPO transitions
AI product work
- ai-shaped-readiness-advisor — assesses whether you're automating tasks (AI-first) or redesigning how you work (AI-shaped), then tells you which competency to build first
- context-engineering-advisor — diagnoses context stuffing vs. context engineering and guides memory architecture for AI-powered products
- agent-orchestration-advisor — guides multi-agent workflow design across four dimensions
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:
| Section | What it contains |
|---|---|
| Frontmatter | name, description, type, intent, best_for, scenarios |
| Purpose | What this skill does and when to reach for it |
| Input | What 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 Concepts | Frameworks, definitions, anti-patterns — with vocabulary explained |
| Application | Step-by-step instructions an agent (or human) can follow |
| Examples | Real-world cases showing both good and bad versions |
| Common Pitfalls | Named failure modes with consequences and corrections |
| References | Related 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
| Document | Purpose |
|---|---|
| Using PM Skills 101 | Beginner-friendly orientation — setup without technical overload |
| Platform Guides for PMs | Tool-by-tool setup chooser for every supported platform |
| Using PM Skills with Claude | Claude Code + GitHub ZIP upload for Claude Desktop/Web |
| Using PM Skills with Codex | Local workspace + GitHub-connected Codex on ChatGPT |
| Using PM Skills with ChatGPT | GitHub app, Custom GPT Knowledge, and Project-based usage |
| Using PM Skills with Slash Commands 101 | Turn skills into reusable slash commands like /pm-story |
| Add-a-Skill Utility Guide | End-to-end guide for generating and validating new skills |
| Market Intelligence Suite Summary | The 14-skill competitive/market research suite: disciplines, chain, and which skill to run when |
| Lifecycle & EOL Suite Summary | The 8-skill lifecycle/sunset suite: the three plays, the EOL chain, and right-sizing |
| Building PM Skills | How raw PM content gets distilled into agent-ready skills |
| START_HERE.md | 60-second onboarding for local repo users |
What's New
v0.86 — November 13, 2026 · The Everyday Work of Product, Now on the Map
- 12 new skills fill the map: Discover gains Dig (
survey-design-advisor,usage-data-investigation,discovery-habits-advisor) and Decode (research-synthesis,assumption-mapping); Develop gains Drumbeat (backlog-refinement-advisor,sprint-planning,release-readiness); Drive gains Delineate (decision-rights-matrix,pm-role-charter); Deliver gains Deepen (activation-design,retention-diagnostic-advisor) - Pick your slice, not all 95: agents are converging on installable plugins and bundles, so the lifecycle bundles let you install what matches your work
- Easier to start: a five-minute path on the README's first screen, a layered
START_HERE.md, a clearer Desktop install, and a docs style guard - Older packs
02-07retired; every skill in them lives in a lifecycle bundle - Library at 95 skills · full story in the release note
v0.85 — November 13, 2026 · Lifecycle Bundles, a Navigator, and the Go-to-Market Gap Filled
- Six installable lifecycle bundles that follow the product arc: Determine, Discover, Define, Develop, Deliver, plus Drive (stakeholders and career) underneath. Install one with
/plugin install pm-define@pm-skills, or download its pack for Claude Desktop. Every skill still runs on its own pm-skills-navigator: describe what's on your desk and get routed to the right phase and skill- Go-to-market, filled:
launch-plan,launch-metrics,message-house,sales-value-narrative,buying-journey-enablement - Also:
LICENSING.md, an OpenCode install guide, and drift guards for prose counts - Library now at 83 skills · full story in the release note
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-advisorandproduct-lifecycle-playsdiagnose 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
- 14 new skills + 2 major upgrades — the biggest single addition in the library's history. Run competitive and market research like an intelligence agency instead of a term paper: eight collection disciplines (OSINT → MASINT), signal → inference chains, confidence stacking, and a fusion cadence
- New interaction mode:
autonomous-investigation— the protocol for research that proceeds without you. Question budgets, a search-plan gate, Fact / Inference / Assumption labels on every claim, do-not-invent lists, and stable diffable schemas, so investigations can run on a schedule and you can diff this quarter against last - The investigation chain (market-landscape-scan → competitive-research-snapshot → competitive-intel-watch → battle-card-builder), evidence-cited strategy frameworks (swot-analysis, porters-five-forces, ansoff-matrix), monitors and miners (voice-of-customer-miner, pricing-packaging-tracker, pestel-delta-monitor), and the six-step umbrella competitive-analysis-process
- Upgraded:
tam-sam-som-calculator(three entry modes, including autonomous bottom-up research) andcompany-intel(Executive Signal Refresh rerun pattern — Then/Now diffs and Dropped Language: what leaders stop saying is often the strongest signal) - Library now at 70 skills · full story in the release note
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
## Inputsection: 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-hintautocomplete for Claude Code users; deliberately no$ARGUMENTStemplating — 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
$ARGUMENTSin 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.jsonthat silently blocked Claude Code skill discovery - Added configurable input length guard (
PM_MAX_INPUT) and path traversal protection to helper scripts
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
- GitHub Issues: Report bugs or suggest features
- LinkedIn: Dean Peters
- Productside: AI PM consulting and training
Details
- Marketplace
- deanpeters/Product-Manager-Skills
- Source
- skills/message-house
- Category
- Strategy
More from deanpeters/Product-Manager-Skills
All 102- opportunity-solution-tree
- organic-growth-advisor
- pestel-analysis
- pestel-delta-monitor
- pm-define
- pm-deliver
- pm-determine
- pm-develop
- pm-discover
- pm-drive
- pm-role-charter
- pm-skill-creator
- pm-skills-navigator
- pol-probe
- pol-probe-advisor
- porters-five-forces
- positioning-statement
- positioning-workshop
- prd-development
- press-release
- pricing-packaging-tracker
- prioritization-advisor
- problem-framing-canvas
- problem-statement
Similar to message-house
More Development Tools
reamorluto/rea466.8K starsReverse engineer anything with agents, from app behavior down to native binaries.
superpowersobra/superpowers319.5K starsCore skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques
claude-apianthropics/skills196.9K starsClaude API and SDK documentation skill for building LLM-powered applications
prompts.chatf/prompts.chat178.2K starsAccess thousands of AI prompts and skills directly in your AI coding assistant. Search prompts, discover skills, save your own, and improve prompts with AI.
agent-sdk-devanthropics/claude-code156.1K starsDevelopment kit for working with the Claude Agent SDK
ui-ux-pro-maxnextlevelbuilder/ui-ux-pro-max-skill152.6K starsProfessional UI/UX design intelligence for AI coding assistants. Includes searchable databases of styles, colors, typography, charts, and UX guidelines for Reac