skills/business/product-management/SKILL.md
Product management workflows — feature specs, roadmap planning, stakeholder updates, user research synthesis, competitive analysis, metrics review, sprint planning. Use when writing specs, updating roadmaps, briefing stakeholders, synthesizing research, or reviewing product metrics.
npx skillsauth add notque/claude-code-toolkit product-managementInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Umbrella skill for PM workflows: specs, roadmaps, stakeholder comms, research synthesis, competitive analysis, metrics review, sprint planning, and product brainstorming. Each mode loads its own reference files on demand.
Classify into one mode before proceeding.
| Mode | Signal Phrases | Reference |
|------|---------------|-----------|
| SPEC | write spec, PRD, feature requirements, acceptance criteria, user stories | references/spec-writing.md |
| ROADMAP | roadmap, prioritize, Now/Next/Later, reprioritize, timeline, OKR alignment | references/roadmap-planning.md |
| STAKEHOLDER | stakeholder update, status report, executive brief, launch announcement | (inline templates) |
| RESEARCH | synthesize research, interview analysis, user feedback, personas, thematic analysis | references/research-synthesis.md |
| COMPETITIVE | competitive brief, competitor analysis, battle card, positioning, win/loss | (inline templates) |
| METRICS | metrics review, KPI, funnel analysis, retention, cohort, dashboard, OKR scoring | references/metrics-review.md |
| SPRINT | sprint planning, backlog grooming, capacity, sprint goal, carryover | (inline templates) |
| BRAINSTORM | brainstorm, explore problem, stress-test idea, thinking partner, assumption testing | (Socratic — see below) |
If the request spans modes, pick the primary mode and note the secondary.
Load: references/spec-writing.md, references/llm-pm-failure-modes.md
| Section | Content | |---------|---------| | Problem Statement | 2-3 sentences. Who, how often, cost of not solving. Grounded in evidence. | | Goals | 3-5 measurable outcomes. Outcomes not outputs. | | Non-Goals | 3-5 explicit exclusions with rationale. | | User Stories | "As a [specific type], I want [capability] so that [benefit]." Group by persona. Include edge cases. | | Requirements | P0 (must-have), P1 (nice-to-have), P2 (future). Each with acceptance criteria. | | Success Metrics | Leading (days-weeks) and lagging (weeks-months). Specific targets with measurement method. | | Open Questions | Tagged by owner (eng, design, legal, data). Blocking vs non-blocking. | | Timeline | Hard deadlines, dependencies, phasing. |
Acceptance criteria format: Given/When/Then or checklist. Cover happy path, error cases, edge cases. No ambiguous words ("fast", "intuitive") without concrete definitions.
Scope management: Write explicit non-goals. Any scope addition requires a scope removal or timeline extension. Separate v1 from v2. Time-box investigations.
Load: references/roadmap-planning.md, references/llm-pm-failure-modes.md
| Operation | Inputs | Key Actions | |-----------|--------|-------------| | Add item | Name, priority, effort, timeframe, owner, dependencies | Suggest placement based on priorities and capacity | | Update status | Item + new status (not started / in progress / at risk / blocked / completed / cut) | For at-risk/blocked: require blocker + mitigation | | Reprioritize | What changed (strategy shift, new data, resource change) | Apply framework (RICE, ICE, MoSCoW, Value/Effort). Show before/after. | | Move timeline | Why (scope change, dependency slip, resource constraint) | Identify downstream impacts. Flag hard-deadline conflicts. | | Create new | Timeframe, format preference, initiative list | Use Now/Next/Later unless user specifies otherwise |
Capacity rule: When adding to roadmap, always ask "What comes off?" Roadmaps are zero-sum against capacity.
| Audience | Frame | Length | |----------|-------|--------| | Executives | Outcome-focused, G/Y/R status, strategic alignment | < 300 words | | Engineering | Technical detail, links to PRs/tickets, decisions needed with options | As needed | | Cross-functional | Impact on their team, asks with deadlines, input opportunities | Medium | | Customers | Benefits-focused, no jargon, honest timelines | Short | | Board | Metrics-driven, risk-focused, strategic | Very concise |
Executive update rule: Lead with conclusion, not journey. "We shipped X and it moved Y" not "we had 14 standups." Status color reflects reality, not optimism.
Gate: Update draft exists. Audience-appropriate framing verified (no engineering jargon in exec updates, no hand-waving in engineering updates). Every risk has a ROAM classification.
Load: references/research-synthesis.md, references/llm-pm-failure-modes.md
| | High Impact | Low Impact | |---|---|---| | High Frequency | Top priority | Quality-of-life | | Low Frequency | Segment-specific | Note and deprioritize |
Critical rule: Distinguish behaviors from stated preferences. Behavioral data always outweighs what users say they want. Quote attribution uses participant type ("Enterprise admin, 200-person team"), never names.
Honesty rule: Dismissing competitors makes analysis useless. Rate based on real product experience and customer feedback, not marketing claims. Be honest about where competitors lead.
Gate: Competitive brief exists with feature matrix, positioning analysis, and strategic implications. At least one honest "they lead here" finding present.
Load: references/metrics-review.md, references/llm-pm-failure-modes.md
| Level | Purpose | Examples | |-------|---------|---------| | North Star | Core value delivered | WAU completing core workflow | | L1 (Health) | Lifecycle stages | Acquisition, Activation, Engagement, Retention, Monetization, Satisfaction | | L2 (Diagnostic) | Drill-down | Funnel steps, feature adoption, segment breakdowns, performance |
Context rule: Absolute numbers without comparison are useless. Always show vs previous period, vs target, vs benchmark. Small fluctuations are noise — focus on meaningful changes.
Gate: Sprint plan exists with goal, capacity table, prioritized backlog, and load vs capacity check showing 70-80% target.
This mode is fundamentally different. The PM does not get a deliverable. They get a thinking partner. Be opinionated. Push back. Bring unexpected angles. Challenge assumptions.
Session principles:
Sub-modes — Detect which fits and shift as conversation evolves:
| Sub-mode | When | Approach | |----------|------|----------| | Problem Exploration | PM has a problem area, not a defined problem | Ask "who has this problem?" and "what are they doing today?" Map the ecosystem. Distinguish symptoms from root causes. | | Solution Ideation | Problem is well-defined, need options | Generate 5-7 distinct approaches before evaluating. Include one "do the opposite" and one "remove something." Resist early convergence. | | Assumption Testing | PM has a direction, needs stress-testing | List every assumption (stated + unstated). Find the riskiest one. Suggest the cheapest test. Play devil's advocate. | | Strategy Exploration | Big bets, positioning, direction | Map possible moves. Think in bets (odds, payoff). Consider second-order effects and competitive responses. |
Session rhythm: Frame -> Diverge -> Provoke -> Converge -> Capture.
Ideation techniques:
Frameworks as thinking tools (use when they help, not as templates):
| Framework | Structure | Failure Mode | |-----------|-----------|-------------| | HMW | "How might we [outcome] for [user] without [constraint]?" | Too broad ("improve onboarding") or too narrow ("add tooltip to step 3") | | JTBD | "When [situation], I want to [motivation] so I can [outcome]." | Functional jobs are easy; emotional and social jobs are often more powerful. Ask "what did they fire?" | | Opportunity Solution Tree | Outcome -> Opportunities (from research) -> Solutions (multiple per opportunity) -> Experiments (cheapest test) | Opportunities must trace to evidence, not imagination. One solution per opportunity = not enough exploration. | | First Principles | State assumption -> Break to fundamentals -> Question each -> Rebuild | Use when team is stuck in incrementalism | | OODA | Observe -> Orient -> Decide -> Act -> loop | Most teams get stuck in Orient. OODA says: orient with what you have, act, let next cycle correct. | | Reverse Brainstorming | "How to make this worse?" -> List -> Reverse each | When team is stuck; people are better at identifying wrong than imagining right. |
Provocation prompts:
Gate: Session produced at least one challenge the PM hadn't considered. Captured decisions/next-steps documented. Frameworks used as thinking tools, not dumped as checklists.
See references/llm-pm-failure-modes.md for the complete failure mode catalog (vague specs, fabricated research, generic competitive analysis, metrics without context, happy-path-only specs, framework regurgitation, scope creep enablement). Universal failure modes in skills/shared-patterns/llm-domain-failure-modes-base.md.
Used in SPEC, ROADMAP, and SPRINT modes.
| Framework | Formula / Method | Best For | |-----------|-----------------|----------| | RICE | (Reach x Impact x Confidence) / Effort | Large backlog, quantitative comparison | | ICE | Impact x Confidence x Ease (1-10 each) | Quick prioritization, early-stage | | MoSCoW | Must / Should / Could / Won't | Scoping a release, forcing prioritization conversations | | Value vs Effort | 2x2 matrix: Quick Wins, Big Bets, Fill-ins, Money Pits | Visual prioritization in team sessions |
Failure modes: Using a framework as a rubber stamp for a decision already made. If the RICE score does not match intuition, investigate why — do not just adjust the inputs until it does.
documentation
Document translation: quick/normal/refined modes with chunked parallel subagents and glossary support.
development
AI image generation: Gemini and Nano Banana backends; single/series/batch workflows with prompt-to-disk.
testing
Unified voice content generation pipeline with mandatory validation and joy-check. 13-phase pipeline: LOAD, GROUND, STATS-CHECKPOINT, GENERATE, HOOK-GATE, VALIDATE, REFINE, VARIETY-GATE, JOY-CHECK, ANTI-AI, CLOSE-GATE, OUTPUT, CLEANUP. Use when writing articles, blog posts, or any content that uses a voice profile. Use for "write article", "blog post", "write in voice", "generate content", "draft article", "write about".
documentation
Critique-and-rewrite loop for voice fidelity validation.