product-discovery
Structured product discovery before building. Covers the four product risks, opportunity assessment, customer discovery, prototype selection, discovery sprints, and evidence-based build / pivot / kill decisions. Use when evaluating whether a product, feature, or workflow deserves delivery investment.
Best use case
product-discovery is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Structured product discovery before building. Covers the four product risks, opportunity assessment, customer discovery, prototype selection, discovery sprints, and evidence-based build / pivot / kill decisions. Use when evaluating whether a product, feature, or workflow deserves delivery investment.
Teams using product-discovery should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/product-discovery/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How product-discovery Compares
| Feature / Agent | product-discovery | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Structured product discovery before building. Covers the four product risks, opportunity assessment, customer discovery, prototype selection, discovery sprints, and evidence-based build / pivot / kill decisions. Use when evaluating whether a product, feature, or workflow deserves delivery investment.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
SKILL.md Source
# Product Discovery Acknowledgement: Shared by Peter Bamuhigire, techguypeter.com, +256 784 464178. <!-- dual-compat-start --> ## Use When - Evaluating a new product idea or market opportunity. - De-risking a major feature before it enters the backlog. - Deciding whether to pivot or persevere on an existing product direction. - Running a time-boxed discovery sprint with a cross-functional team. ## Do Not Use When - The work is already defined at feature level and only needs implementation sequencing. - The request is a narrow screen-level UX refinement with no product-risk question. ## Required Inputs - Business objective, target market, and the product or feature idea under review. - Available research, usage data, constraints, and stakeholder context. ## Workflow - Read this `SKILL.md` first, then load only the referenced deep-dive files that are necessary for the task. - Use the four risks to decide what needs evidence, then choose the cheapest prototype or test that can answer the risk. - End with a concrete recommendation and the evidence supporting it. - For premium products, test willingness to pay, proof threshold, perceived quality, decision process, and buyer commitment before treating positive feedback as demand. ## Quality Standards - Discovery must produce decisions, not theater. - Success metrics must be defined before deeper investment. - Prototype fidelity should stay as low as possible while still answering the risk question. ## Anti-Patterns - Treating output volume as discovery progress. - Asking customers about hypothetical future preferences instead of present behavior. - Using colleagues or stakeholders as stand-ins for target users without recording the limitation. ## Outputs - Opportunity assessment, discovery brief, test plan, prototype recommendation, evidence summary, and build / pivot / kill recommendation. ## References - Use `enterprise-ux-process` when the work has enterprise constraints, stakeholder churn, or requirement ambiguity. <!-- dual-compat-end --> Based on Cagan (2017) *INSPIRED: How to Create Tech Products Customers Love*, 2nd ed. ## The 4 Product Risks Every product must clear four risks before full delivery investment: | Risk | Question | Validated By | |------|----------|-------------| | Value | Will customers choose to use or buy this? | Demand tests, interviews | | Usability | Can customers figure out how to use it? | Prototype testing | | Feasibility | Can we build it with our team, tech, and time? | Engineering spike | | Business Viability | Does it work for the business? | Stakeholder review | For premium offers, add a fifth commercial proof question: will the right buyer pay a premium now, and what proof, risk reduction, service layer, or authority asset is required for that decision? ## Opportunity Assessment Before committing to deeper discovery, capture: 1. Business objective 2. Key results 3. Customer problem 4. Target market If these are unclear, the opportunity is not ready. ## Customer Discovery Rules - Ask about current behavior, not speculative future wishes. - Keep the target market narrow. - Recruit real reference customers early when possible. - Use prototypes and manual concierge work before large build commitments. ## Prototype Selection Choose the cheapest prototype that answers the risk: | Prototype Type | Best For | |---|---| | Feasibility prototype | Technical uncertainty | | User prototype | Usability and task flow | | Live-data prototype | Value and workflow realism | | Hybrid prototype | Mixed risk across value, usability, and feasibility | ## Discovery Sprint Run a 1-2 week cycle: 1. Frame the opportunity. 2. Interview target users. 3. Prototype 2-3 directions. 4. Test with real users. 5. Make a build / pivot / kill recommendation. ## Companion Skills - `enterprise-ux-process` for feature-definition inside enterprise delivery environments. - `feature-planning` once the opportunity passes discovery. --- ## ARRIVE: separating Research from Reframe Many discovery processes collapse "research" and "synthesis" into one phase, which is exactly the failure mode that produces decks nobody acts on. The ARRIVE framework treats them as distinct stages — Research is ethnographic gathering, Reframe is the deliberate scope-and-meaning shift that names what to build against. Load `references/arrive-framework.md` for: - The two-R front end (Research, then Reframe — never collapsed). - The Persona Needs Matrix and the Reframed Project Vision template that locks in scope. - The Concept Board (A) for low-fidelity concepts that test the *idea*, not the polish. - The Assumption Map (importance × evidence) that prioritises which assumptions to validate first. - Strategic Suitability as a fourth dimension alongside Desirability/Viability/Feasibility. Use ARRIVE's Reframe stage as a hard checkpoint: the client signs off on the new frame before any concept work begins. Without that gate, ideation becomes unanchored.
Related Skills
product-strategy-vision
Frameworks for defining a compelling product vision and a focused product strategy. Covers the 10 principles of product vision, product strategy principles, OKR technique for product teams, outcome-based roadmaps, product principles, and product...
product-led-growth
Use when designing PLG motions for a SaaS product — freemium tiers, PQL definition, activation flows with time-to-value targets, in-app upgrade prompts, viral loops, NPS surveys, feature flags for gradual rollout, and PostHog-based product analytics for funnel and cohort tracking.
premium-software-product-execution
Use when designing, building, pricing, packaging, or reviewing premium software products, SaaS systems, ERP/POS tools, dashboards, websites, or agency-built applications for executive, enterprise, affluent, high-ticket, or elite buyers. Converts premium marketing, selling, product, UX, pricing, proof, onboarding, and delivery principles into concrete software requirements and quality gates.
web-app-security-audit
Use when auditing a PHP/JavaScript/HTML web application for security vulnerabilities. Covers configuration, authentication, authorization, input validation, XSS, API security, HTTP headers, and dependency scanning. Produces a severity-rated audit...
vibe-security-skill
Use when designing or reviewing security for a web application, API, or multi-tenant SaaS — produces threat model, abuse case list, auth/authz matrix, and secret handling plan; covers OWASP Top 10 2025 and the AI-code-generation blind spots. Neighbours — api-design-first owns auth model fields, deployment-release-engineering owns secret rotation choreography, ai-security and llm-security own model-specific threats.
network-security
Use when designing, hardening, or auditing network-layer security for self-managed Debian/Ubuntu SaaS infrastructure — firewalls (nftables/UFW), WAF (ModSecurity + OWASP CRS), VPN (WireGuard, OpenVPN, IPsec), TLS/PKI ops, IDS/IPS (Suricata, Fail2ban), zero-trust, SSH hardening, DDoS mitigation, DNS security. Complements web-app-security-audit (app layer) and cicd-devsecops (secrets/CI).
linux-security-hardening
Use when hardening a Debian/Ubuntu server — user/group/sudo hardening, file permission audits, PAM password policy + MFA, AppArmor mandatory access control, auditd system call logging, kernel sysctl hardening, file integrity monitoring (AIDE), rootkit detection (rkhunter/chkrootkit), unattended security patching, GRUB + UEFI + LUKS boot security, and CIS benchmark compliance.
dpia-generator
Generate a Data Protection Impact Assessment (DPIA), Uganda DPPA 2019-compliant. Use when producing or reviewing a data protection impact assessment, a privacy impact assessment, when uganda-dppa-compliance flags [DPIA-REQUIRED], or when processing large-scale or sensitive personal data for a new feature.
code-safety-scanner
Scan any codebase for 14 critical safety issues across security vulnerabilities, server stability (500 errors), and payment misconfigurations. Use when auditing code before deployment, reviewing AI-generated code for production readiness, or...
world-class-engineering
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.
update-Codex-documentation
Update project documentation files (README.md, PROJECT_BRIEF.md, TECH_STACK.md, ARCHITECTURE.md, docs/API.md, docs/DATABASE.md, AGENTS.md, docs/plans/NEXT_FEATURES.md) when significant changes occur. MANDATORY at end of each work session to...
skill-writing
Use when creating or upgrading skills in this repository. Covers repository-specific frontmatter rules, progressive disclosure, reference-file strategy, validation, and the quality bar required for production-grade engineering skills.