clarify

Clarify ambiguous requirements through iterative interviews and generate a spec document.

2|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/nextc/nextc-claude --skill clarify-nextc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/nextc/nextc-claude/tree/main/nextc-core/skills/clarify
Command: npx skills add https://github.com/nextc/nextc-claude --skill clarify-nextc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ambiguity in requirements can derail projects; this skill guides iterative, Socratic interviews to elicit a precise, testable spec from vague ideas.

Core Features & Use Cases

  • Interactive interviews that ask one targeted question at a time.
  • Ambiguity scoring that quantifies goal, constraints, and criteria.
  • Spec crystallization that outputs a complete doc to docs/spec/{slug}.md for greenfield or brownfield scenarios.

Quick Start

Provide your idea as {{ARGUMENTS}} and start the iterative questioning to crystallize a clear spec.

Frequently Asked Questions about clarify

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

FAQPage Schema
How do I turn vague ideas into precise requirements specifications?

To turn vague ideas into precise requirements specifications, you can use an interactive Socratic interview process that asks one targeted question at a time to crystallize ambiguous requirements into a clear, testable spec.

How does ambiguity scoring work for requirements gathering?

Ambiguity scoring quantifies goals, constraints, and criteria during requirements gathering by evaluating your responses throughout the iterative interview phases, ensuring all vague aspects of your idea are measured and resolved before generating the final specification.

What is the best way to write a spec for brownfield projects?

The best way to write a spec for brownfield projects is through a disciplined phase-based process that conducts targeted interviews to identify existing constraints, culminating in a complete written specification document stored under docs/spec with metadata and transcript.

Can I use a one-question-per-round interview to clarify project requirements?

Yes, you can use a one-question-per-round interview to clarify project requirements, as this iterative Socratic approach prevents information overload and allows you to systematically address ambiguity in both greenfield and brownfield scenarios before producing a final spec.

When do I need a formal specification document for my project?

You need a formal specification document when ambiguous requirements threaten to derail your project, requiring a structured interview process to elicit precise goals and constraints that result in a testable spec saved as a markdown file with full metadata and interview transcript.

Does the specification generation process support greenfield ideas?

Yes, the specification generation process fully supports greenfield ideas by applying targeted questioning and ambiguity scoring to new concepts, transforming them from scratch into a crystallized, testable spec document with proper frontmatter and metadata.