deep-clarify

What problem does it solve?

This skill eliminates wasted effort and misalignment caused by vague, undefined project requests by using guided Socratic dialogue to extract clear goals, completion criteria, scope, and constraints from users.

Core Features & Use Cases

• Guided Socratic Questioning: Asks a maximum of 3 rounds of targeted questions (2 per round) to pull out critical details only the user can provide, while inferring obvious implementation details automatically to avoid unnecessary back-and-forth.
• Structured Spec Generation: Compiles conversation results into a standardized, actionable spec document saved to .claude/specs/ for use by downstream agents and development tools.
• Workflow Integration: Automatically suggests the next appropriate skill or agent (such as agent-composer for orchestration or the plan agent for design review) based on the clarified requirements.
• Use Case: If you have a rough idea like "build a customer onboarding flow" but no clear requirements, this skill will walk you through simple, focused questions to define success metrics, excluded features, and priority, then output a ready-to-use spec for your implementation team.

Quick Start

Invoke the deep-clarify skill with your vague project idea to receive a structured specification document ready for implementation.