recommendation-canvas▌
deanpeters/product-manager-skills · updated Apr 8, 2026
MDX-style export adds YAML metadata + attribution linking explainx.ai and this canonical listing URL.
Structured canvas for evaluating AI product ideas across outcomes, hypotheses, risks, and positioning.
- ›Synthesizes 10 strategic components: business outcomes, customer outcomes, problem framing, solution hypotheses, positioning, assumptions, PESTEL risks, value justification, success metrics, and next steps
- ›Designed for AI-specific uncertainty; treats solutions as testable bets rather than commitments, with lightweight \"Tiny Acts of Discovery\" experiments built in
- ›Outcome-driven fr
Purpose
Evaluate and propose AI product solutions using a structured canvas that assesses business outcomes, customer outcomes, problem framing, solution hypotheses, positioning, risks, and value justification. Use this to build a comprehensive, defensible recommendation for stakeholders and decision-makers—especially when proposing AI-powered features or products that carry higher uncertainty and risk.
This is not a feature spec—it's a strategic proposal that articulates why this AI solution is worth building, what assumptions need validating, and how you'll measure success.
Key Concepts
The Recommendation Canvas Framework
Created for Dean Peters' Productside "AI Innovation for Product Managers" class, the canvas synthesizes multiple PM frameworks into one strategic view:
Core Components:
- Business Outcome: What's in it for the business?
- Product Outcome: What's in it for the customer?
- Problem Statement: Persona-centric problem framing
- Solution Hypothesis: If/then hypothesis with experiments
- Positioning Statement: Value prop and differentiation
- Assumptions & Unknowns: What could invalidate this?
- PESTEL Risks: Political, Economic, Social, Technological, Environmental, Legal
- Value Justification: Why this is worth doing
- Success Metrics: SMART metrics to measure impact
- What's Next: Strategic next steps
Why This Works
- Outcome-driven: Forces clarity on business AND customer value
- Hypothesis-centric: Treats solution as a bet to validate, not a commitment
- Risk-explicit: Makes assumptions and risks visible upfront
- Executive-friendly: Comprehensive but structured for C-level review
- AI-appropriate: Especially useful for AI features with high uncertainty
Anti-Patterns (What This Is NOT)
- Not a PRD: This is strategic framing, not detailed requirements
- Not a business case (yet): It informs the business case but needs validation first
- Not a feature list: Focus on outcomes, not capabilities
When to Use This
- Proposing a new AI-powered product or feature
- Pitching to execs or securing budget/sponsorship
- Evaluating whether an AI solution is worth pursuing
- Aligning cross-functional stakeholders (product, engineering, data science, business)
- After completing initial discovery (you need context to fill this out)
When NOT to Use This
- For trivial features (don't over-engineer small tweaks)
- Before any discovery work (you need user research and problem validation first)
- As a replacement for experimentation (canvas informs experiments, not vice versa)
Application
Use template.md for the full fill-in structure.
Step 1: Gather Context
Before filling out the canvas, ensure you have:
- Problem understanding: User research, pain points (reference
skills/problem-statement/SKILL.md) - Persona clarity: Who experiences the problem? (reference
skills/proto-persona/SKILL.md) - Market context: Competitive landscape, category positioning
- Business constraints: Budget, timelines, strategic priorities
If missing context: Run discovery work first. This canvas synthesizes insights—it doesn't create them.
Step 2: Define Outcomes
Business Outcome
What's in it for the business? Use this format:
- [Direction] [Metric] [Outcome] [Context] [Acceptance Criteria]
## Business Outcome
- [e.g., "Reduce by 25% the churn of existing customers using our existing product"]
Example:
- "Increase by 15% the monthly recurring revenue from enterprise customers within 12 months"
Quality checks:
- Measurable: Can you track this metric?
- Time-bound: Within what timeframe?
- Ambitious but realistic: Not "10x revenue in 1 month"
Product Outcome
What's in it for the customer? Use this format:
- [Direction] [Metric] [Outcome] [Context from persona's POV] [Acceptance Criteria]
## Product Outcome
- [e.g., "Increase the speed of finding patients when I know the inclusion and exclusion criteria"]
Example:
- "Reduce by 60% the time spent manually processing invoices for small business owners"
Quality checks:
- Customer-centric: Written from user perspective ("I," not "we")
- Outcome, not feature: "Reduce time spent" not "Use AI automation"
Step 3: Frame the Problem
Use the problem framing narrative from skills/problem-statement/SKILL.md:
## The Problem Statement
### Problem Statement Narrative
- [Persona description: 2-3 sentences telling the persona's story from their POV]
- [Example: "Sarah is a freelance designer managing 10 clients. She spends 8 hours/month manually tracking invoices and chasing late payments. By the time she follows up, some clients have already moved to other designers, costing her revenue and damaging relationships."]
Quality checks:
- Empathetic: Does this sound like the user's voice?
- Specific: Not "users want better tools" but "Sarah spends 8 hours/month..."
- Validated: Based on real user research, not assumptions
Step 4: Define the Solution Hypothesis
Hypothesis Statement
Use the epic hypothesis format from skills/epic-hypothesis/SKILL.md:
## Solution Hypothesis
### Hypothesis Statement
**If we** [action or solution on behalf of target persona]
**for** [target persona]
**Then we will** [attain or achieve desirable outcome]
Example:
- "If we provide AI-powered invoice reminders that auto-send at optimal times for freelance designers, then we will reduce time spent on payment follow-ups by 70%"
Tiny Acts of Discovery
Define lightweight experiments to validate the hypothesis:
### Tiny Acts of Discovery
**We will test our assumption by:**
- [Experiment 1: Prototype AI reminder system and test with 5 freelancers]
- [Experiment 2: A/B test manual vs. AI-timed reminders for 20 users]
- [Experiment 3: Survey users on perceived value after 2 weeks]
Quality checks:
- Fast: Days/weeks, not months
- Cheap: Prototypes, concierge tests, not full builds
- Falsifiable: Could prove you wrong
Proof-of-Life
Define validation measures:
### Proof-of-Life
**We know our hypothesis is valid if within** [timeframe]
**we observe:**
- [Quantitative outcome: e.g., "80% of users send reminders via the AI system"]
- [Qualitative outcome: e.g., "8 out of 10 users report saving 5+ hours/month"]
Step 5: Define Positioning
Use the positioning statement format from skills/positioning-statement/SKILL.md:
## Positioning Statement
### Value Proposition
**For** [target customer/user persona]
**that need** [statement of underserved need]
[product name]
**is a** [product category]
**that** [statement of benefit, focusing on outcomes]
### Differentiation Statement
**Unlike** [primary competitor or competitive arena]
[product name]
**provides** [unique differentiation, focusing on outcomes]
Step 6: Document Assumptions & Unknowns
## Assumptions & Unknowns
- **[Assumption 1]** - [Description, e.g., "We assume users will trust AI-generated reminders"]
- **[Assumption 2]** - [Description, e.g., "We assume payment timing optimization increases response rates"]
- **[Unknown 1]** - [Description, e.g., "We don't know if users prefer email or SMS reminders"]
Quality checks:
- Explicit: Make hidden assumptions visible
- Testable: Each assumption can be validated via experiments
Step 7: Identify PESTEL Risks
Risks to Investigate (High Priority)
## Issues/Risks to Investigate
- **Political:** [e.g., "Regulatory changes to AI-generated communications"]
- **Economic:** [e.g., "Economic downturn reduces willingness to pay for premium features"]
- **Social:** [e.g., "Users may perceive AI reminders as impersonal or pushy"]
- **Technological:** [e.g., "AI model accuracy may degrade over time without retraining"]
- **Environmental:** [e.g., "Energy costs of AI processing"]
- **Legal:** [e.g., "GDPR compliance for storing customer email patterns"]
Risks to Monitor (Lower Priority)
## Issues/Risks to Monitor
- **Political:** [e.g., "Potential AI regulation in EU markets"]
- **Economic:** [e.g., "Exchange rate fluctuations affecting international customers"]
- **Social:** [e.g., "Changing norms around automated communication"]
- **Technological:** [e.g., "Emerging AI competitors with better models"]
- **Environmental:** [e.g., "Carbon footprint concerns from stakeholders"]
- **Legal:** [e.g., "Future data privacy laws"]
Step 8: Justify the Value
## Value Justification
### Is this Valuable?
- [Absolutely yes / Yes with caveats / No with suggested alternatives / Absolutely NO!]
### Solution Justification
<!-- Write these to convince C-level executives -->
We think this is a valuable idea. Here's why:
1. **[Justification 1]** - [Description, e.g., "Addresses the #1 pain point for our target segment"]
2. **[Justification 2]** - [Description, e.g., "Differentiates us from competitors who only offer manual reminders"]
3. **[Justification 3]** - [Description, e.g., "Low technical risk—leverages existing AI infrastructure"]
Step 9: Define Success Metrics
Use SMART metrics (Specific, Measurable, Attainable, Relevant, Time-Bound):
## Success Metrics
1. **[Metric 1]** - [e.g., "80% of active users adopt AI reminders within 3 months"]
2. **[Metric 2]** - [e.g., "Average time spent on payment follow-ups decreases by 50% within 6 months"]
3. **[Metric 3]** - [e.g., "Net Promoter Score for invoicing feature increases from 6 to 8 within 6 months"]
Step 10: Define Next Steps
## What's Next
1. **[Next step 1]** - [e.g., "Run 2-week prototype test with 10 beta users"]
2. **[Next step 2]** - [e.g., "Build lightweight AI model for reminder timing optimization"]
3. **[Next step 3]** - [e.g., "Conduct legal review of GDPR implications"]
4. **[Next step 4]** - [e.g., "Present findings to exec team for go/no-go decision"]
5. **[Next step 5]** - [e.g., "If validated, add to Q2 roadmap"]
Examples
See examples/sample.md for a full recommendation canvas example.
Mini example excerpt:
How to use recommendation-canvas on Cursor
AI-first code editor with Composer
Prerequisites
Before installing skills in Cursor, ensure your development environment meets these requirements:
- ›Cursor installed and configured on your development machine
- ›Node.js version 16.0+ with npm package manager (verify with
node --version) - ›Active project directory or workspace where you want to add recommendation-canvas
Execute installation command
Execute the skills CLI command in your project's root directory to begin installation:
The skills CLI fetches recommendation-canvas from GitHub repository deanpeters/product-manager-skills and configures it for Cursor.
Select Cursor when prompted
The CLI will show a list of available agents. Use arrow keys to navigate and space to select Cursor:
Verify installation
Confirm successful installation by checking the skill directory location:
Reload or restart Cursor to activate recommendation-canvas. Access the skill through slash commands (e.g., /recommendation-canvas) or your agent's skill management interface.
Security & Verification Notice
We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.
Skills execute code in your development environment. Always verify the publisher's identity, review recent commits, and test in isolated environments before production deployment.
List & Monetize Your Skill
Submit your Claude Code skill and start earning
Use Cases▌
User Story & Requirements Generation
Create detailed user stories, acceptance criteria, and feature specs
Example
Generate user stories for 'password reset feature' with acceptance criteria, edge cases, and test scenarios
Reduce spec writing time by 50%, ensure comprehensive coverage
Competitive Analysis
Research competitors, compare features, identify gaps
Example
Analyze 5 competitor products, create feature comparison matrix, suggest differentiation opportunities
Complete competitive research in 2 hours instead of 2 days
Roadmap Prioritization
Evaluate features using frameworks (RICE, ICE, Kano) and create prioritized backlogs
Example
Score 20 feature ideas using RICE framework, generate prioritized roadmap with rationale
Make data-driven prioritization decisions faster
Stakeholder Communication
Draft PRDs, status updates, and stakeholder presentations
Example
Create executive summary of Q3 roadmap, monthly progress report, feature launch announcement
Save 3-5 hours/week on communication overhead
Implementation Guide▌
Prerequisites
- ›Claude Desktop or compatible AI client
- ›Access to product documentation and roadmap tools (Jira, Notion, etc.)
- ›Understanding of product management frameworks (RICE, Jobs-to-be-Done, etc.)
- ›Stakeholder contact information and communication channels
Time Estimate
30-60 minutes to see productivity improvements
Installation Steps
- 1.Install product management skill
- 2.Start with user story generation for known feature
- 3.Progress to competitive analysis: research 2-3 competitors
- 4.Use for roadmap prioritization: apply RICE/ICE scoring
- 5.Draft stakeholder communications and refine based on feedback
- 6.Build template library for recurring PM tasks
- 7.Share effective prompts with product team
Common Pitfalls
- ⚠Not validating competitive research—verify facts before sharing
- ⚠Accepting user stories without involving engineering team
- ⚠Over-relying on frameworks without qualitative judgment
- ⚠Not customizing outputs to company culture and communication style
- ⚠Skipping stakeholder validation of generated requirements
Best Practices▌
✓ Do
- +Validate research and competitive analysis with real data
- +Collaborate with engineering when generating technical requirements
- +Customize frameworks and templates to your company context
- +Use skill for first drafts, refine with stakeholder input
- +Document successful prompt patterns for PM tasks
- +Combine AI efficiency with human judgment and intuition
✗ Don't
- −Don't publish competitive analysis without fact-checking
- −Don't finalize user stories without engineering review
- −Don't make prioritization decisions solely on AI scoring
- −Don't skip customer validation of generated requirements
- −Don't ignore company-specific context and culture
💡 Pro Tips
- ★Provide context: company goals, constraints, customer feedback
- ★Ask for alternatives: 'Show 3 ways to prioritize this roadmap'
- ★Request stakeholder-specific formatting: 'Executive summary vs. engineering spec'
- ★Use skill for 70% generation + 30% customization to company needs
When to Use This▌
✓ Use When
Use for user story writing, competitive research, roadmap prioritization, stakeholder communication, and PRD drafting. Best for reducing repetitive documentation and research work.
✗ Avoid When
Avoid for strategic product vision (requires deep customer empathy), pricing decisions (needs market and financial expertise), or when face-to-face customer discovery is more valuable than speed.
Learning Path▌
- 1Basic: user stories, feature specs, status updates
- 2Intermediate: competitive analysis, prioritization frameworks, PRDs
- 3Advanced: product strategy, go-to-market planning, OKR setting
- 4Expert: product vision, market positioning, business model innovation
Discussion
Product Hunt–style comments (not star reviews)- No comments yet — start the thread.
Ratings
4.5★★★★★51 reviews- ★★★★★Valentina Dixit· Dec 28, 2024
Useful defaults in recommendation-canvas — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
- ★★★★★Hana Mehta· Dec 28, 2024
recommendation-canvas fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
- ★★★★★Fatima Nasser· Dec 8, 2024
recommendation-canvas has been reliable in day-to-day use. Documentation quality is above average for community skills.
- ★★★★★Michael Li· Nov 27, 2024
Keeps context tight: recommendation-canvas is the kind of skill you can hand to a new teammate without a long onboarding doc.
- ★★★★★Diego Anderson· Nov 23, 2024
I recommend recommendation-canvas for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
- ★★★★★Henry Ghosh· Nov 19, 2024
recommendation-canvas is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
- ★★★★★Zara Mehta· Nov 19, 2024
We added recommendation-canvas from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
- ★★★★★Ren Patel· Nov 7, 2024
Solid pick for teams standardizing on skills: recommendation-canvas is focused, and the summary matches what you get after install.
- ★★★★★Olivia Garcia· Oct 26, 2024
I recommend recommendation-canvas for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
- ★★★★★Michael Kim· Oct 18, 2024
We added recommendation-canvas from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
showing 1-10 of 51