speckit-clarify

Generate clarifying questions for underspecified feature specs in .specify/.

4|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/ghbvf/gocell --skill speckit-clarify-ghbvf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/ghbvf/gocell/tree/main/.claude/skills/speckit-clarify
Command: npx skills add https://github.com/ghbvf/gocell --skill speckit-clarify-ghbvf

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill identifies underspecified areas in the current feature spec and generates a concise set of clarifying questions to resolve ambiguities before planning and implementation. The questions help ensure complete requirements, reduce rework, and guide decision-making.

Core Features & Use Cases

  • Detect ambiguities in requirements, acceptance criteria, and constraints.
  • Generate up to 5 targeted questions and capture answers back into the spec.
  • Incrementally update the spec with clarifications under a dedicated Clarifications section for traceability.

Quick Start

Run the clarifying workflow on the active feature spec to begin collecting questions.

Frequently Asked Questions about speckit-clarify

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

FAQPage Schema
How do I identify ambiguities in a feature specification before implementation?

You can resolve ambiguities in feature requirements by running an interactive clarifying session that generates up to five targeted questions. The session captures your answers and incrementally updates the spec under a dedicated Clarifications section for traceability.

What is the best way to generate clarifying questions for underspecified acceptance criteria?

The best way to generate clarifying questions for acceptance criteria is to analyze the spec for underspecified areas and produce a focused, succinctly answerable set. This ensures complete requirements and reduces rework before planning begins.

How do I update a feature spec incrementally while preserving requirement traceability?

You update a feature spec incrementally by adding accepted answers to a dedicated Clarifications section. This preserves traceability by ensuring each generated question and its clarification are captured directly within the existing specification document.

Does this clarifying workflow work with specs stored in the .specify/ directory?

Yes, the clarifying workflow applies directly to feature specifications stored in the .specify/ directory. It processes the active spec file to detect ambiguities and guides an interactive session to refine requirements and implementation details.

When do I need to clarify feature requirements using targeted question generation?

You need to clarify feature requirements using targeted question generation when planning and implementation begin. Generating questions early resolves constraints, reduces rework, and ensures decision-making is guided by complete requirements before development starts.