speckit-clarify

Identify underspecified spec areas and record answers into a Clarifications section.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identify underspecified areas in a feature spec by orchestrating up to 5 targeted clarification questions and encoding answers back into the spec, reducing rework and speeding alignment.

Core Features & Use Cases

  • Clarification planning: assess spec gaps across functional, data, UX, performance, and edge cases, then propose prioritized questions.
  • Interactive questioning loop: present one question at a time, with a recommended option and reasoning, track answers, and update the spec with a Clarifications section.
  • Safe and auditable updates: apply clarifications directly to the spec with versioned edits and validation.

Quick Start

Run the speckit clarify workflow to begin a guided clarification session against the active feature 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?

Identifying underspecified areas in a feature specification involves assessing functional, data, UX, performance, and edge case gaps, then proposing prioritized clarification questions to resolve ambiguities.

How do I update a spec with clarification answers?

Updating a spec with clarification answers involves recording responses directly into a Clarifications section, ensuring changes are auditable through versioned edits and incremental tracking after each accepted answer.

Can I use an interactive workflow to resolve feature specification gaps?

Yes, you can resolve feature specification gaps using an interactive workflow that presents one targeted question at a time with a recommended option and reasoning, tracking answers to guide stakeholders toward alignment.

Does spec clarification require a specific project directory structure?

Spec clarification requires a spec-kit project structure that uses a .specify/ directory workflow to apply clarifications directly to the active feature spec with safe and auditable versioned edits.

What is the best way to ensure specification changes are auditable?

The best way to ensure specification changes are auditable is to create a Clarifications section within the spec and incrementally update it with versioned edits after each accepted answer during the questioning loop.