product-discovery/SKILL.md
Structured product discovery process before building. Covers the 4 product risks, opportunity assessment, customer discovery programs, prototype spectrum, demand/value/feasibility testing, and discovery sprints. Use when evaluating whether an...
npx skillsauth add peterbamuhigire/skills-web-dev product-discoveryInstall 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.
product-discovery or would be better handled by a more specific companion skill.SKILL.md first, then load only the referenced deep-dive files that are necessary for the task.Based on Cagan (2017) INSPIRED: How to Create Tech Products Customers Love, 2nd ed.
The core discipline: Separate discovery (figuring out what to build) from delivery (building it). Discovery is how you avoid building the wrong thing. Discovery is not optional for competitive products.
Every product must clear all four risks before committing to full delivery.
| Risk | Question | Validated By | |------|----------|-------------| | Value | Will customers choose to use or buy this? | Demand tests, qualitative interviews | | Usability | Can customers figure out how to use it? | Usability testing on prototypes | | Feasibility | Can we build it with our current team, tech, and time? | Engineering spike, feasibility prototype | | Business Viability | Does this work for our business (legal, financial, marketing, sales)? | Stakeholder review |
Never hand work to engineering with unresolved value or feasibility risk. One week of discovery prototyping routinely saves months of misdirected development.
Before committing to discovery, frame the opportunity with four questions (replaces a traditional product requirements document at the discovery stage).
If you cannot answer all four, the opportunity is not ready for discovery investment.
The goal is to recruit 6 reference customers — real users who will use your product from day one and whose endorsement you can cite when selling to others.
A single target market is not a limitation — it is a requirement for focus. Trying to be everything to everyone in discovery produces a product that is nothing to no one.
Use these at the start of discovery to align the team before generating solutions.
Write the press release announcing the product — from the customer's point of view — before building it. Forces the team to articulate customer value in plain language. If you cannot write this letter compellingly, the opportunity is not yet well understood.
Map the end-to-end customer journey as a 2D grid: user tasks across the top (time axis), story details beneath each task. Reveals gaps in coverage, prioritisation candidates, and the MVP slice (the horizontal cut that delivers a complete but minimal journey).
Rapid one-page framing: Problem, Solution, Key Metrics, Unique Value Proposition, Channels, Customer Segments, Cost Structure, Revenue Streams. Use for new product lines or pivots.
The single most important and most misused discovery tool.
Rules:
Do the job manually for the customer before building the software. If you cannot do it manually for 5 customers, you do not yet understand the problem well enough to build it.
Prototypes are learning tools, not deliverables. Build the cheapest prototype that answers the specific risk question. Never gold-plate a discovery prototype.
| Prototype Type | Purpose | Risk Addressed | Fidelity | |---------------|---------|----------------|---------| | Feasibility Prototype | Prove a technical approach is buildable | Feasibility | Low (code spike) | | User Prototype | Test usability and user flow | Usability, Value | Low-Medium (click-through) | | Live-Data Prototype | Test with real data at small scale | Value, Feasibility | Medium-High | | Hybrid Prototype | Combines manual + automated to simulate full product | All 4 risks | Varies |
A Figma click-through costs 1 hour and answers usability questions that 2 weeks of engineering cannot answer. Build the prototype first.
Use before building to verify customers want the solution enough to act.
Engineering lead runs a technical spike (time-boxed prototype) to validate:
Present the proposed solution to each internal stakeholder group and get explicit sign-off:
Do not hand off to delivery without explicit viability sign-off from each relevant stakeholder.
A time-boxed (1–2 week) intensive discovery cycle for high-risk opportunities.
Product Manager + Product Designer + 1–2 Engineers (for feasibility) + optional: data analyst.
| Anti-Pattern | Why It Fails | Correct Approach | |-------------|-------------|-----------------| | Feature Factory | Teams measure output (features shipped), not outcome (value delivered). | Define success metrics before starting discovery. | | HiPPO decisions | Highest-Paid Person's Opinion overrides evidence. | All decisions require prototype or data evidence. | | Discovery by committee | Too many voices; no decisions. | PM owns the decision after consulting stakeholders. | | Skipping feasibility | Builds technically impossible commitments into roadmap. | Engineer must be present in discovery, not just delivery. | | Validating with colleagues | Colleagues are too polite and too familiar with your thinking. | Test with target customers only. | | Showing mockups, not prototypes | Customers react to aesthetics, not function. | Use the lowest-fidelity prototype that simulates the key interaction. |
product-strategy-vision — strategy defines which opportunities to discoverfeature-planning — approved opportunities become planned featureslean-ux-validation — UX-focused validation methods; this skill covers broader opportunity and business riskdata-ai
Use when adding AI-powered analytics to a SaaS platform — semantic search over business data, natural language queries, trend detection, anomaly alerts, and AI-generated insights for dashboards. Covers embeddings, NL2SQL, and per-tenant analytics...
data-ai
Design AI-powered analytics dashboards — what metrics to show, how to display AI predictions and confidence, drill-down patterns, KPI cards, trend visualisation, AI Insights panels, export design, and role-based dashboard variants. Invoke when...
development
Use when designing, building, reviewing, or upgrading production software systems that must be secure, performant, maintainable, scalable, and user-centered. Apply before writing specs, code, architecture, APIs, databases, mobile apps, SaaS platforms, or ERP systems.
development
Professional web app UI using commercial templates (Tabler/Bootstrap 5) with strong frontend design direction when needed. Use for CRUD interfaces, dashboards, admin panels with SweetAlert2, DataTables, Flatpickr. Clone seeder-page.php, use...