product-clarify

Identify underspecified areas in PDRs and refine them through targeted clarification questions.

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/chaimt/GarminShabbatMode --skill product-clarify
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: product-clarify
Source: https://github.com/chaimt/GarminShabbatMode/tree/main/.cursor/skills/product-clarify
Command: npx skills add https://github.com/chaimt/GarminShabbatMode --skill product-clarify

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Product Decision Records (PDRs) often contain gaps in context, consequences, metrics, and alternatives. This Skill guides teams through structured clarification to tighten requirements and prepare PRD generation.

Core Features & Use Cases

  • Defines a quality checklist for PDRs and surfaces gaps across context, decision clarity, alternatives, risks, and success metrics.
  • Automates interactive clarification by proposing precise questions and collecting concise responses.
  • Integrates with the spec-kit workflow to load drafts from .specify and align with constitution memory for governance-driven improvements.

Quick Start

Run the clarify workflow against the current PDR drafts to generate targeted questions and refine gaps.

Frequently Asked Questions about product-clarify

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

FAQPage Schema
How do I identify gaps in a Product Decision Record before generating a PRD?

To identify gaps in a Product Decision Record, analyze context, decision clarity, alternatives, risks, and success metrics. This Skill surfaces underspecified areas in existing PDRs through a structured quality checklist to tighten requirements.

How do I clarify underspecified PDRs using guided questions?

You clarify underspecified PDRs by proposing precise, targeted clarification questions one at a time. This interactive process collects concise responses to refine context, consequences, and metrics, ensuring completeness before PRD generation.

How does PDR clarification work with spec-kit drafts and governance memory?

PDR clarification integrates with the spec-kit workflow by loading drafts from the .specify directory. It aligns PDRs with constitution memory to analyze completeness, consistency, and governance alignment for governance-driven improvements.

When should I use targeted clarification questions for product management?

Use targeted clarification questions for product management when existing PDRs contain gaps in context, consequences, metrics, and alternatives. This Skill guides teams through structured clarification to prepare for cross-PDR reconciliation and PRD generation.

Can I automate cross-PDR reconciliation after refining PDR drafts?

Yes, you can automate cross-PDR reconciliation after refining drafts. Once interactive clarification collects concise responses, the Skill outputs PDR updates and performs reconciliation across documents to prepare for PRD generation.