ambiguity-detection

Detect critical ambiguities in product requirements documents and generate structured clarification questions.

Updated Dec 29, 2025
One-click install
npx skills add https://github.com/Z1-Test/temp-dhruvil-st15 --skill ambiguity-detection-z1-test
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ambiguity-detection
Source: https://github.com/Z1-Test/temp-dhruvil-st15/tree/main/.github/skills/doc-ambiguity-detection
Command: npx skills add https://github.com/Z1-Test/temp-dhruvil-st15 --skill ambiguity-detection-z1-test

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill identifies and expresses critical ambiguities in requirements or PRDs as structured clarification questions, ensuring decision completeness and minimizing rework.

Core Features & Use Cases

  • Ambiguity Detection: Identifies product, scope, data, risk, and success ambiguities.
  • Clarification Questions: Provides structured, decision-forcing questions without proposing solutions.
  • Use Case: Before roadmap definition, feature decomposition, or execution planning, use this Skill to validate PRDs and detect hidden assumptions.

Quick Start

Run the ambiguity-detection skill on the requirements document 'product-reqs.md'.

Frequently Asked Questions about ambiguity-detection

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

FAQPage Schema
How do I detect ambiguities in a product requirements document?▼

To detect ambiguities in a product requirements document, you analyze the PRD text to surface product, scope, data, risk, and success gaps. This process identifies hidden assumptions and generates structured clarification questions to force decision-making.

What is requirements clarification and when do I need it for roadmap planning?▼

Requirements clarification is the process of identifying decision gaps in product specs to prevent misalignment. You need it before roadmap definition, feature decomposition, or execution planning to validate PRDs and minimize downstream rework.

How do I generate structured clarification questions from a PRD?▼

You generate structured clarification questions from a PRD by running text analysis scripts against the requirements file. The process evaluates the document for ambiguities and outputs decision-forcing questions without proposing technical solutions.

Do I need Python to analyze requirements for decision gaps?▼

Yes, you need Python to analyze requirements for decision gaps because the detection process requires Python libraries for text analysis and processing. These scripts parse the PRD content to identify ambiguities and generate structured outputs.

What is the best way to validate PRDs before feature decomposition?▼

The best way to validate PRDs before feature decomposition is to systematically scan for product, scope, data, risk, and success ambiguities. This approach ensures decision completeness by surfacing hidden assumptions as structured clarification questions.