agentsclimarketplace

Product discovery

Skill magnus919/agent-skills/product-discovery

Discover product requirements from human stakeholders — map who to talk to, ask questions that surface hidden assumptions, detect gaps in real time, resolve conflicts, and translate conversations into structured SDD specs. Phase 0 upstream of Spec-Driven Development.From its SKILL.md

Install
npx -y skills add magnus919/agent-skills --skill product-discovery

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • 29 days oldThe repository was created 29 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
  • 21 stars21 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its file declares

Copied from the file, not written here

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

6.8 KB, ~1.4k tokens by cl100k_base, as published. Nobody here has run it

Product Discovery — Stakeholder Map

Pre-discovery work begins before any conversation. Load this reference first when planning discovery:

ReferenceLoad whenFile
Stakeholder Mapping & SequencingYou need to decide who to interview and in what orderreferences/stakeholder-mapping.md
Interview Protocol DesignYou're designing a question stack for a specific stakeholder typereferences/question-patterns.md
Gap Detection TechniquesYou're preparing to recognize what stakeholders don't sayreferences/gap-detection.md

Pipeline: Phase 0 — Discovery

RAW NEED → [MAP] → [INTERVIEW] → [SYNTHESIZE] → [DISTILL] → [VALIDATE] → SPEC.md
              |           |              |            |            |
         Who to       What to        Resolve      Convert to   Stakeholder
         talk to      ask            conflicts    structured   review

Load the reference for the phase you're entering.

Core principles

  • Closed questions confirm what you already think; open questions discover what you didn't know to ask. If the answer can be "yes" or "no," you're validating, not discovering.
  • Knowledge holders come first; authority holders validate — they don't originate. The person who knows the problem is not the same person who approves the budget.
  • Conflicts are almost never about what they appear to be. Surface disagreements are proxies for unstated differences in assumptions, risk tolerance, or incentives.
  • Every weasel word represents a gap. "Probably," "ideally," "eventually" — each is a known issue the stakeholder hasn't committed to addressing.

Quick Start — Where to Enter

You have thisStart here
A vague idea or problem spaceLoad references/stakeholder-mapping.md — identify who to interview
An interview scheduled with no protocolLoad references/question-patterns.md and references/gap-detection.md — design your question stack
Raw interview notes from one or more sessionsLoad references/transcript-to-spec.md — distill into structured spec components
A draft spec that needs stakeholder verificationLoad references/transcript-to-spec.md (Interpretation Audit Trail section) — run the validation loop
Stakeholders who disagree on requirementsLoad references/conflict-resolution.md — classify and resolve before spec
Limited time with a stakeholderLoad references/time-constrained-discovery.md — maximize signal in minimal time
An AI agent conducting interviewsLoad references/ai-conducted-discovery.md — account for sycophancy and trust dynamics

Done with discovery? Use product-methodology to choose scope, then product-design-and-ux to define user-facing behavior. Jump to the Is Discovery Complete? checklist at the bottom.

Trigger Conditions

Load this skill when:

  • You're starting product discovery for a new feature or project
  • You have a vague idea that needs to become a structured specification
  • You need to interview stakeholders but don't have a protocol
  • You have raw interview notes that need to become a SPEC.md
  • You're about to enter Phase 1 (SPECIFY) of SDD and need upstream input
  • You're evaluating whether you've done enough discovery work

Loading Guide

PhaseLoad WhenFile
MAPYou need to identify who to interview, in what order, and how to find the right stakeholdersreferences/stakeholder-mapping.md
INTERVIEWYou're about to conduct stakeholder interviews and need question patterns, gap detection, and conflict handlingreferences/question-patterns.md + references/gap-detection.md + references/conflict-resolution.md
SYNTHESIZEYou have raw interview notes and need to identify conflicts, risks, and gaps before distillationreferences/conflict-resolution.md
DISTILLYou need to transform interview notes into structured SPEC.md with ACs, edge cases, and NFRsreferences/transcript-to-spec.md
VALIDATEYou have a draft spec and need to verify interpretations with stakeholdersreferences/transcript-to-spec.md (Interpretation Audit Trail section)

Cross-Cutting Concerns

These dimensions apply across all phases. Load when relevant:

ConcernLoad whenFile
AI-conducted discoveryAn AI agent is conducting discovery interviewsreferences/ai-conducted-discovery.md
Power dynamicsStakeholders span multiple organizational levels; hierarchy may distort responsesreferences/power-dynamics.md
Time constraintsStakeholder time is limited; need maximum signal extractionreferences/time-constrained-discovery.md

Templates

TemplatePipeline PhaseLoad whenFile
Discovery PlanMAPYou need to structure the full discovery effort — stakeholder map, interview schedule, timelinetemplates/discovery-plan.md
Interview GuideINTERVIEWYou need a structured question stack for an interview sessiontemplates/interview-guide.md
Distillation WorksheetDISTILLYou're transforming raw notes into structured spec componentstemplates/distillation-worksheet.md
Gap RegisterSYNTHESIZEYou need to track unresolved gaps, deferred decisions, and open questions across interviewstemplates/gap-register.md
Interpretation LogDISTILL → VALIDATEYou need to track every translation from stakeholder language to spec languagetemplates/interpretation-log.md

Quick Reference: Is Discovery Complete?

Before handing off to SDD Phase 1 (SPECIFY), check:

  • All stakeholder types interviewed (knowledge holders, authority holders, affected parties, implementation knowers)?
  • At least 3 independent sources for every requirement?
  • Abstract nouns decomposed into measurable thresholds?
  • Conflicts resolved or documented with decision-maker identified?
  • Edge cases extracted from stakeholder anecdotes?
  • Every AC classified: SAID / IMPLIED / INTERPRETED / INFERRED?
  • HIGH-risk interpretations identified and flagged for validation?
  • Gaps, deferred decisions, and avoided topics documented?
  • Stakeholder validation loop completed?
  • Interpretation audit trail preserved for handoff?

What ships with it: 15 files

49.5 KB alongside SKILL.md

evals/

Keep looking

Skills are one crate of 326,834. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.