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.