speckit-clarify

Identify underspecified areas in a feature specification and update the SPEC file.

Updated Jun 8, 2025
One-click install
npx skills add https://github.com/cicero78M/Cicero_Web --skill speckit-clarify-cicero78m
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/cicero78M/Cicero_Web/tree/main/.agents/skills/speckit-clarify
Command: npx skills add https://github.com/cicero78M/Cicero_Web --skill speckit-clarify-cicero78m

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Speckit-clarify helps teams identify underspecified areas in a feature specification by driving a focused clarification session and encoding the outcomes back into the spec.

Core Features & Use Cases

  • Guided ambiguity detection across functional scope, data model, interactions, non-functional constraints, and integration points.
  • Interactive, single-session questioning loop that yields at most 5 questions and records answers in a new Clarifications section.
  • Automatic spec update: appends Q/A bullets under Clarifications/Session YYYY-MM-DD and applies changes to relevant sections (Functional Requirements, Data Model, User Stories, etc.)

Quick Start

Start the clarifications workflow by answering the first question to begin updating 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 underspecified areas in a feature specification?

To identify underspecified areas in a feature specification, run a guided interactive session that prompts up to five targeted questions to detect ambiguity across functional scope, data model, interactions, and integration points.

How do I update a SPEC file with clarification answers automatically?

To update a SPEC file with clarification answers, execute a single interactive questioning loop that appends accepted answers as Q/A bullets under a dedicated Clarifications section and progressively applies changes to relevant specification areas.

What is the best way to document specification requirements interactively?

The best way to document specification requirements interactively is using a focused clarification workflow that validates each answer and persists it directly to the SPEC file, ensuring headings, formatting, and terminology remain consistent.

Can I use a single session to clarify functional requirements and data models?

Yes, you can use a single session to clarify functional requirements and data models, as the workflow drives guided ambiguity detection across both domains and records all answers in one centralized Clarifications section.

How many clarification questions can I expect during a specification review?

During a specification review, you can expect at most five targeted clarification questions designed to resolve underspecified areas within a single interactive loop before persisting the validated answers.