clarify

Identify and resolve project specification ambiguities through targeted questions.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/overthestream/agent-dotfile --skill clarify-overthestream
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/overthestream/agent-dotfile/tree/main/claude/skills/clarify
Command: npx skills add https://github.com/overthestream/agent-dotfile --skill clarify-overthestream

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Clarify skill helps teams uncover and resolve unclear requirements by guiding a structured ambiguity scan and an interactive questioning loop.

Core Features & Use Cases

  • Ambiguity Scan across key categories (functional, domain, interaction, non-functional, integration, edge cases, constraints, terminology, completion signals, misc)
  • Prioritized questions generation based on impact and uncertainty
  • Interactive, one-question-at-a-time clarification workflow
  • Documentation of clarified decisions and updated specifications

Quick Start

Initiate the clarification flow by asking the first ambiguity question to the user.

Frequently Asked Questions about clarify

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

FAQPage Schema
How do I resolve ambiguities in project specifications before implementation?▼

You can resolve ambiguities in project specifications by running a structured 10-category ambiguity scan that generates prioritized questions based on impact and uncertainty, guiding you through an interactive clarification loop.

What is an ambiguity scan in software architecture and requirements gathering?▼

An ambiguity scan is a systematic review across ten key categories—functional, domain, interaction, non-functional, integration, edge cases, constraints, terminology, completion signals, and misc—to identify unclear requirements during spec design and architectural planning.

How do I clarify requirements for task decomposition when specs are unclear?▼

You can clarify requirements for task decomposition by initiating an interactive, one-question-at-a-time workflow that prioritizes missing information by impact, iteratively collecting answers to update the specification.

When do I need to use a structured clarification process for spec design?▼

You need a structured clarification process for spec design when architectural planning or task decomposition encounters unclear requirements, ensuring all functional, non-functional, and edge case assumptions are documented before implementation begins.

What is the best way to prioritize requirement questions during architectural planning?▼

The best way to prioritize requirement questions during architectural planning is to evaluate them based on their impact on the system and their level of uncertainty, ensuring high-risk ambiguities are resolved first through an interactive loop.

Does the interactive clarification workflow document decisions for updated specifications?▼

Yes, the interactive clarification workflow documents clarified decisions and generates updated specifications, ensuring that resolved ambiguities from the questioning loop are recorded for the implementation phase.