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.