speckit-clarify

Identify underspecified areas in feature specs and generate up to five clarifying questions.

Updated Mar 4, 2026

Search Tags:#automation #workflow #documentation #specification #requirements #interactive #clarify

Ready to run

npx skills add https://github.com/kerolos-saaid/refranario --skill speckit-clarify-kerolos-saaid

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/kerolos-saaid/refranario/tree/main/.agents/skills/speckit-clarify
Command: npx skills add https://github.com/kerolos-saaid/refranario --skill speckit-clarify-kerolos-saaid

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identify underspecified areas in the current feature specification by asking up to five targeted clarification questions and encoding answers back into the spec.

Core Features & Use Cases

Detect gaps, ambiguities, and missing decision points in active specs.
Generate a bounded set (up to five) of clarifying questions, prioritizing high-impact areas.
Produce a structured "Clarifications" section in the spec and apply answers in real-time with traceable changes.

Quick Start

Start a targeted clarification session against the active feature spec to initialize the workflow.

Frequently Asked Questions about speckit-clarify

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

FAQPage Schema

How do I identify gaps and ambiguities in a feature specification?▼

To identify gaps in a feature specification, you can run an interactive clarification workflow that detects underspecified areas and asks up to five targeted questions to resolve missing decision points.

How do I integrate clarification answers back into a project spec?▼

You integrate clarification answers by appending them to a structured Clarifications section within the spec, ensuring traceable decisions and safe, testable updates inside the project structure.

What is the best way to automate feature requirement clarification?▼

The best way to automate requirement clarification is using a workflow that generates a bounded set of high-impact questions, encodes answers in real-time, and maintains daily-session notes for traceability.

Can I use interactive clarification for an existing .specify project structure?▼

Yes, you can use interactive clarification against an existing .specify project structure to initialize a targeted clarification session that safely updates active feature specifications.

Does the clarification workflow limit the number of questions asked per session?▼

Yes, the clarification workflow limits generation to a maximum of five targeted questions per session to prioritize high-impact underspecified areas and prevent scope creep.

Why are daily-session notes needed for specification clarifications?▼

Daily-session notes are needed to maintain traceable decisions, track real-time updates, and ensure that every encoded answer within the Clarifications section remains auditable for future reference.