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.