clarify-first

Clarify ambiguous user requests through targeted questioning before implementation.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/TudeOrangBiasa/zenithgravity-kit --skill clarify-first-tudeorangbiasa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify-first
Source: https://github.com/TudeOrangBiasa/zenithgravity-kit/tree/main/.agent/skills/clarify-first
Command: npx skills add https://github.com/TudeOrangBiasa/zenithgravity-kit --skill clarify-first-tudeorangbiasa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents wasted development effort by ensuring that ambiguous user requests are clarified before any implementation begins, avoiding misinterpretations and costly rework.

Core Features & Use Cases

  • Ambiguity Detection: Identifies requests lacking clear scope, data models, or API contracts.
  • Targeted Questioning: Asks precise, numbered questions to resolve uncertainty.
  • Use Case: When a user asks to "improve the user profile section," this skill will prompt for specifics like "Which aspects of the profile need improvement (e.g., UI, data fields, performance)?" and "Are there specific metrics you want to track for this improvement?".

Quick Start

Use the clarify-first skill to ask clarifying questions about the ambiguous request to update the user authentication module.

Frequently Asked Questions about clarify-first

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

FAQPage Schema
How do I resolve ambiguity in software requirements before coding?

To resolve ambiguity in software requirements, you must employ targeted questioning to define scope, data models, and API contracts before any implementation begins. This prevents wasted development effort and avoids misinterpretations that lead to costly rework.

How do you gather requirements for high-risk operations with undefined scope?

Gathering requirements for high-risk operations with undefined scope requires asking precise, numbered questions to resolve uncertainty. This ensures adherence to artifact-first principles by preventing premature coding and establishing clear API contracts.

What is the best way to define API contracts and data models from unclear requests?

The best way to define API contracts and data models from unclear requests is through targeted questioning that identifies missing specifics. Asking precise questions about metrics and functional aspects ensures scope definition before development starts.

When do I need to clarify scope for an ambiguous user update request?

You need to clarify scope for an ambiguous user update request when the request lacks clear parameters regarding UI, data fields, or performance. Detecting this ambiguity early prevents misinterpretations and ensures accurate data models are defined.

Does this approach work for preventing premature coding in artifact-first workflows?

Yes, this approach works for preventing premature coding in artifact-first workflows by managing ambiguous requests through targeted questioning. It enforces scope definition and data model agreement before any implementation logic is written.