discover

Converts a feature request into problem, hypothesis, scope, risks, and success metric.

Updated Sep 17, 2026
One-click install
npx skills add https://github.com/karenrebecag/spec-driven-standards --skill discover-karenrebecag
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: discover
Source: https://github.com/karenrebecag/spec-driven-standards/tree/main/plugins/product/skills/discover
Command: npx skills add https://github.com/karenrebecag/spec-driven-standards --skill discover-karenrebecag

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams often jump straight from a request like "build me a dashboard" into writing specs, without validating the underlying problem. This Skill turns a raw request into a structured discovery document covering the real problem, the affected user, a falsifiable hypothesis, a measurable success metric, scope, explicit exclusions, and risks—before any spec is written. ## Core Features & Use Cases - Problem reframing: Recovers the actual user pain hidden behind a solution-shaped request, asking one targeted question when the problem is ambiguous. - Structured discovery document: Produces problem, primary user, falsifiable hypothesis, success metric with baseline, scope, explicit exclusions, and technical/user/business risks. - Reuse check and human decision boundary: Prompts checking whether an existing solution covers 80% of the need, then stops so prioritization remains a human decision. - Use Case: A stakeholder asks for a new reporting dashboard. Run /discover to surface that the real problem is slow weekly reporting, define a hypothesis and a baseline metric, and hand an approved discovery to /spec. ## Quick Start Invoke /discover with a feature request such as "we need a notifications center" to get a structured discovery document with problem, hypothesis, metric, scope, and risks.

Frequently Asked Questions about discover

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate a feature request before writing a spec?

Run /discover on the request to reframe it as a problem statement, identify the primary user, and define a falsifiable hypothesis with a measurable success metric. The output is a discovery document that feeds directly into /spec once approved.

What should a product discovery document include?

A discovery document should include the problem in user terms, the primary user and context, a falsifiable hypothesis, one measurable success metric with a baseline, iteration scope, explicit exclusions, and technical, user, and business risks.

How does discovery fit into a spec-driven development workflow?

Discovery is step zero: it converts a request into a validated problem before /spec turns it into traceable requirements. The success metric defined during discovery is later measured by /learn in production to close the cycle.

Does the discover skill decide whether to build a feature?

No. The skill produces the discovery document and stops deliberately. Prioritization—whether to build it and when—is an explicit human decision, not something the skill automates.

When should I not use a discovery phase for a request?

Skip discovery when the problem, user, and success metric are already validated and documented, or for trivial changes with no ambiguity. Discovery adds value when a request is a disguised solution or lacks a measurable outcome.