speckit-clarify

Identifies and encodes clarifications for feature specification gaps.

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/gherrerz/deepwiki --skill speckit-clarify-gherrerz
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/gherrerz/deepwiki/tree/main/.claude/skills/speckit-clarify
Command: npx skills add https://github.com/gherrerz/deepwiki --skill speckit-clarify-gherrerz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires spec-kit, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps identify and reduce underspecified areas in feature specifications by asking up to 5 highly targeted clarification questions, encoding answers back into the spec, and improving the spec's clarity and completeness.

Core Features & Use Cases

  • Identify Underspecified Areas: Detect and reduce ambiguity or missing decision points in the active feature specification.
  • Interactive Questioning Loop: Sequentially present questions to the user, allowing for answers that can be short answers or multiple-choice selections.
  • Integration into Spec: Record clarifications directly in the spec file, updating sections as needed.
  • Spec Quality Checklist: Re-validate the spec quality checklist against the updated spec (if available).
  • Completion Report: Provide a report on the number of questions asked & answered, path to the updated spec, and spec quality checklist status.

Quick Start

Use the speckit-clarify skill to clarify a feature specification by running the command: /speckit-clarify [optional areas to clarify in 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 clarify ambiguous areas in a feature specification?▼

You can identify missing decision points in a feature specification by running this Skill, which sequentially presents targeted clarification questions and records your short or multiple-choice answers back into the spec.

How do I update my spec file with clarification answers?▼

This Skill requires a spec-kit project structure containing a .specify/ directory to function. Without this specific environment setup, it cannot identify underspecified areas or encode answers back into the spec.

Does feature specification clarification work with any project structure?▼

No, feature specification clarification requires a spec-kit project structure with a .specify/ directory. Without this specific environment, the Skill cannot identify underspecified areas or encode answers back into the spec.

What happens after I answer the specification clarification questions?▼

After you answer the specification clarification questions, the Skill re-validates the spec quality checklist against the updated spec and provides a completion report detailing the number of questions answered and the checklist status.