skills/business/product-management/SKILL.md
Product management: feature specs, roadmaps, stakeholder updates, user research synthesis, competitive analysis, metrics, sprint planning.
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.
tools
Shell configuration: Fish and Zsh setup, PATH, completions, plugins.
tools
Kubernetes operations: debugging, security, RBAC, and infrastructure tooling.
development
Swift development: concurrency patterns, async/await, actors, testing with XCTest and Swift Testing framework.
development
PHP development: code quality, PSR standards, testing with PHPUnit.