skills/product-management/SKILL.md
Product roadmapping, prioritization, and specification writing. Use when: building a product roadmap, prioritizing features using RICE or other frameworks, writing product requirements documents (PRDs), creating user stories, defining acceptance criteria, planning sprints or milestones, evaluating feature requests, making build vs buy decisions for product features, auditing an existing roadmap for focus, or writing product specs for engineering handoff.
npx skillsauth add michaelsvanbeek/personal-agent-skills 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.
Score each initiative on four dimensions:
| Dimension | Definition | Scale | |-----------|-----------|-------| | Reach | How many users/customers will this impact per quarter? | Absolute number (e.g., 500 users) | | Impact | How much will this move the target metric per user? | 3 = massive, 2 = high, 1 = medium, 0.5 = low, 0.25 = minimal | | Confidence | How sure are you about reach and impact estimates? | 100% = high, 80% = medium, 50% = low | | Effort | How many person-months will this take? | Absolute number (e.g., 2 person-months) |
RICE Score = (Reach × Impact × Confidence) / Effort
Example:
| Initiative | Reach | Impact | Confidence | Effort | RICE Score | |-----------|-------|--------|-----------|--------|------------| | API rate limiting | 2,000 | 2 | 80% | 1 | 3,200 | | Dark mode | 5,000 | 0.5 | 100% | 2 | 1,250 | | SSO support | 200 | 3 | 90% | 3 | 180 | | Mobile app | 3,000 | 2 | 50% | 6 | 500 |
| Dimension | Definition | Scale | |-----------|-----------|-------| | Impact | How much will this improve the target metric? | 1-10 | | Confidence | How sure are we about the impact estimate? | 1-10 | | Ease | How easy is this to implement? | 1-10 |
ICE Score = Impact × Confidence × Ease
Best for quick triage when you don't have detailed reach data.
Categorize rather than score:
| Category | Definition | Rule | |----------|-----------|------| | Must have | Non-negotiable for this release; product fails without it | If you cut it and the release is useless, it's a Must | | Should have | Important but not critical; workarounds exist | Significant value, but launch is viable without it | | Could have | Nice-to-have; include if time allows | Incremental improvement, not essential | | Won't have | Explicitly out of scope for this cycle | Prevents scope creep; document for future |
For visual prioritization:
High Value
│
Quick │ Big Bets
Wins ★ │ (plan carefully)
│
──────────────┼──────────────
│
Fill-ins │ Money Pit
(maybe) │ (avoid)
│
Low Value
Low Effort ←──────→ High Effort
| Type | Time horizon | Audience | Detail level | |------|-------------|----------|-------------| | Vision roadmap | 12-24 months | Board, investors, company all-hands | Themes and strategic bets | | Strategic roadmap | 6-12 months | Leadership, cross-functional teams | Initiatives with goals and rough timing | | Delivery roadmap | 1-3 months | Engineering, design, QA | Epics, milestones, dependencies | | Now/Next/Later | Rolling | Anyone | Simple three-column prioritization |
The simplest and most honest roadmap format:
| Column | Definition | Commitment level | |--------|-----------|-----------------| | Now | Currently in progress or about to start | High — committed, resourced | | Next | Planned for the coming 1-2 months | Medium — sequenced, but may shift | | Later | On the radar but not yet prioritized | Low — under consideration, no timeline |
# [Feature Name]
## Meta
- **Author**: [Name]
- **Status**: Draft / In Review / Approved
- **Target release**: [Quarter or milestone]
- **Last updated**: [Date]
## Problem Statement
[What problem does this solve? Who has this problem? How painful is it?
Include data: support tickets, user research, churn analysis.]
## Goal
[What outcome will this feature drive? Be specific and measurable.]
**Success metric**: [Primary metric this feature moves]
**Target**: [Quantified goal, e.g., "Reduce onboarding drop-off from 40% to 25%"]
## Non-Goals
[Explicitly state what this feature will NOT do. Prevents scope creep.]
- Not building [X]
- Not supporting [Y] in this iteration
- Not optimizing for [Z] persona
## User Stories
### Story 1: [Persona] [action]
**As a** [persona],
**I want to** [action],
**So that** [outcome].
**Acceptance criteria**:
- [ ] [Specific, testable criterion]
- [ ] [Specific, testable criterion]
- [ ] [Specific, testable criterion]
### Story 2: [Persona] [action]
[Same format]
## Design
[Link to designs, wireframes, or mockups.
Include key interaction flows and edge cases.]
## Technical Approach
[High-level technical direction agreed with engineering.
Not a full design doc — enough to unblock estimation.]
- Approach: [Brief description]
- Key dependencies: [APIs, services, libraries]
- Data model changes: [New tables, schema changes]
- Migration needed: [Yes/No — if yes, link to migration plan]
## Edge Cases
| Scenario | Expected behavior |
|----------|------------------|
| [Edge case 1] | [What happens] |
| [Edge case 2] | [What happens] |
| [Error condition] | [How the system responds] |
## Open Questions
- [ ] [Unresolved question 1]
- [ ] [Unresolved question 2]
## Rollout Plan
| Phase | Audience | Duration | Success criteria |
|-------|----------|----------|-----------------|
| Internal dogfood | Team | 1 week | No critical bugs |
| Beta | 10% of users | 2 weeks | [Metric threshold] |
| GA | All users | — | [Metric threshold] |
## Dependencies
| Dependency | Owner | Status | Blocking? |
|-----------|-------|--------|-----------|
| [API change] | [Team] | [Status] | Yes/No |
| Element | Guideline | |---------|---------| | Persona | Specific role, not "the user" — "a team admin", "a free-tier developer" | | Action | What they want to do, in their language | | Outcome | The value they get, not the feature they use | | Acceptance criteria | Testable, binary (pass/fail), and complete | | Size | One story = one sprint or less; split larger stories |
When a feature request comes in (from customers, sales, or stakeholders):
| Question | Why it matters | |----------|---------------| | How many customers have asked for this? | Demand signal vs single-customer noise | | What segment do they represent? | Enterprise ask vs SMB ask has different weight | | What's the underlying problem? | The requested feature may not be the right solution | | What's the cost of NOT doing this? | Churn risk, competitive disadvantage, or nothing | | Does it align with current strategic themes? | Even good ideas can be wrong timing | | What's the estimated effort? | Quick win or multi-quarter investment? |
| Decision | When | Communication | |----------|------|---------------| | Build | Aligns with strategy, clear demand, achievable effort | Add to roadmap with timeline | | Defer | Good idea, wrong timing or dependencies needed first | Acknowledge, add to "Later", explain why | | Decline | Doesn't align with strategy or serves too narrow an audience | Thank, explain positioning, suggest workaround |
When reviewing an existing product roadmap or spec:
When delivering product management artifacts, structure the output as:
development
TypeScript coding standards and type safety conventions. Use when: creating TypeScript files, defining interfaces and types, writing type-safe code, reviewing TypeScript for type correctness, auditing a codebase for type safety gaps, eliminating any or ts-ignore usage, or improving strict-mode compliance. Covers strict typing, avoiding any and ts-ignore, discriminated unions, Zod runtime validation, immutability patterns, and proper type definitions.
testing
Writing clear, actionable tickets in any issue tracker (Jira, Linear, GitHub Issues, ServiceNow, etc.). Use when: creating epics, stories, tasks, bugs, or spikes; writing acceptance criteria; decomposing work for a sprint; linking dependencies between tickets; auditing backlog items for clarity; or coaching a team on ticket quality. Covers title conventions, description templates, acceptance criteria, decomposition rules, dependency linking, and org-specific pluggable configuration.
development
Testing strategy, patterns, and evaluation for software and LLM/AI systems. Use when: writing tests, choosing test boundaries, designing test data, structuring test suites, evaluating LLM outputs, building evaluation pipelines, setting coverage thresholds, auditing test coverage gaps in existing projects, or improving test quality and structure.
development
Writing effective status updates for different audiences and cadences. Use when: writing a weekly status update, preparing a monthly summary, drafting a quarterly review, sending updates to leadership, sharing progress with stakeholders, or improving the clarity and impact of team communications. Covers weekly, monthly, and quarterly formats tailored for upward, lateral, and downward communication.