speckit-clarify

Generate up to five clarification questions and apply answers to a feature specification.

Updated Dec 26, 2025
One-click install
npx skills add https://github.com/BOUROUIS-MOHAMED/monclub_access_python --skill speckit-clarify-bourouis-mohamed
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/BOUROUIS-MOHAMED/monclub_access_python/tree/main/.agents/skills/speckit-clarify
Command: npx skills add https://github.com/BOUROUIS-MOHAMED/monclub_access_python --skill speckit-clarify-bourouis-mohamed

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

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

Core Features & Use Cases

  • Interactive clarification loop that generates up to five questions and records answers in the spec to reduce ambiguity.
  • Automatic updates to the spec under a Clarifications section for traceability and future audits.
  • Cross-functional alignment by surfacing gaps early to minimize downstream rework.

Quick Start

Run the speckit-clarify workflow on the active feature specification to begin the guided clarification loop and apply accepted answers to the spec.

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 and gaps in a feature specification?

To identify ambiguities in a feature specification, run a guided clarification loop that generates up to five targeted questions covering functional scope, data models, user interactions, and non-functional criteria. Accepted answers are then applied directly back into the spec file to close those gaps.

What is the best way to maintain traceability for specification clarification decisions?

Maintaining traceability for specification clarifications is achieved by recording accepted answers directly under a dedicated Clarifications section in the spec file. This updates the specification after each decision, creating an auditable trail of resolved ambiguities before planning begins.

How do I resolve underspecified requirements before starting project planning?

Resolve underspecified requirements before planning by executing an interactive clarification workflow that surfaces cross-functional gaps early. It asks focused questions, encodes the answers back into the active specification, and minimizes downstream rework caused by ambiguous criteria.

Does the clarification workflow target non-functional criteria and data models?

Yes, the clarification workflow explicitly targets non-functional criteria and data models, alongside functional scope and user interactions. It generates highly targeted questions across these four dimensions to ensure all specification gaps are systematically addressed.

Can I update a spec file automatically after answering clarification questions?

Yes, you can update a spec file automatically after answering clarification questions. The workflow applies each accepted answer back into the active feature specification, continuously updating the document to ensure ambiguities are closed prior to development planning.