ambiguity-gate

Score user requests for ambiguity across scope, technical, and acceptance factors.

1|Updated May 21, 2026
One-click install
npx skills add https://github.com/hiddink-ai/hiddink-harness --skill ambiguity-gate-hiddink-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ambiguity-gate
Source: https://github.com/hiddink-ai/hiddink-harness/tree/main/templates/skills/ambiguity-gate
Command: npx skills add https://github.com/hiddink-ai/hiddink-harness --skill ambiguity-gate-hiddink-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the common issue of vague or poorly defined user requests that lead to wasted development time, misaligned expectations, and inefficient agent routing.

Core Features & Use Cases

  • Ambiguity Scoring: Evaluates requests on a 0.0 to 1.0 scale across five critical dimensions including scope, technical specificity, and acceptance criteria.
  • Socratic Clarification: Automatically generates targeted, high-impact questions to resolve ambiguity before implementation begins.
  • Use Case: When a user submits a broad request like "make the dashboard better," this skill analyzes the request, identifies the lack of specific constraints or acceptance criteria, and prompts the user for the necessary details before the agent attempts the work.

Quick Start

Run the ambiguity-gate skill on the current user request to determine if it is clear enough to proceed with implementation.

Frequently Asked Questions about ambiguity-gate

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

FAQPage Schema
How do I check if a user request is clear enough before routing it to an agent?

Ambiguity scoring analyzes user requests by evaluating scope, technical specificity, and acceptance criteria on a 0.0 to 1.0 scale. This pre-routing validation ensures agent tasks are well-defined before execution to minimize project rework.

What is the best way to prevent scope creep from vague development requests?

The best way to prevent scope creep from vague requests is applying proactive constraint validation and Socratic questioning to quantify request clarity. This identifies missing constraints and prompts users for necessary details before implementation begins.

How do I generate targeted questions to resolve request ambiguity automatically?

You generate targeted questions to resolve request ambiguity automatically by using Socratic clarification mechanisms within an ambiguity analysis workflow. This automatically produces high-impact questions addressing missing technical or acceptance criteria.

When do I need to apply constraint validation in a pre-routing workflow?

You need to apply constraint validation in a pre-routing workflow when user requests lack specific constraints or acceptance criteria, such as broad prompts like making a dashboard better. This ensures proactive validation before agent execution.

Does ambiguity analysis work without any external dependencies or components?

Yes, ambiguity analysis works without external dependencies or components, as it operates as a standalone skill. It directly analyzes the text of user requests to score clarity and generate clarification questions independently.