speckit-clarify

Identify underspecified areas in feature specifications and prompt targeted clarification questions.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/alansmello/Amani_ImportadosERP --skill speckit-clarify-alansmello
Or copy as Structured Prompt for Agentβ–Ό
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/alansmello/Amani_ImportadosERP/tree/main/.cursor/skills/speckit-clarify
Command: npx skills add https://github.com/alansmello/Amani_ImportadosERP --skill speckit-clarify-alansmello

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Speckit-clarify identifies underspecified areas in feature specifications and prompts the user with up to five highly targeted clarification questions.

Core Features & Use Cases

  • Structured ambiguity detection across taxonomy categories (Functional, Data, UX, Non-functional, etc.)
  • Interactive questioning loop with one question at a time and candidate answer mappings
  • Automatically updates the spec in a new Clarifications section with session timestamps and per-answer bullets

Quick Start

Start an interactive clarification session against your current spec by running the speckit-clarify skill.

Frequently Asked Questions about speckit-clarify

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

FAQPage Schema
How do I identify underspecified areas in my feature specifications?β–Ό

To clarify software requirements, run an interactive questioning loop that detects ambiguity across taxonomy categories and prompts you with up to five targeted clarification questions one at a time.

How do I automatically update functional requirements and acceptance criteria after clarifying specs?β–Ό

You can automatically update functional requirements and acceptance criteria by recording clarification answers in a dedicated spec section, which then integrates the resolved content into testable bullets across your documentation.

Can I use interactive spec clarification with a .specify folder structure?β–Ό

Yes, interactive spec clarification works specifically with software project specs structured with a .specify folder, recording session timestamps and per-answer bullets directly within the specification files.

What is the best way to handle ambiguity in software project requirements?β–Ό

The best way to handle ambiguity in software project requirements is using structured ambiguity detection that categorizes gaps into Functional, Data, UX, and Non-functional areas before prompting for targeted clarifications.

How many clarification questions does a spec clarification session ask?β–Ό

A spec clarification session asks a maximum of five highly targeted questions, presenting them one at a time with candidate answer mappings to efficiently resolve specification ambiguities.

When should I not use automated spec clarification for my workflow?β–Ό

You should not use automated spec clarification when your software project lacks a .specify folder structure, as the tool requires this specific organization to detect ambiguity and record answers properly.