speckit-clarify

Identify underspecified areas in feature specifications and ask targeted clarification questions.

Updated May 11, 2026
One-click install
npx skills add https://github.com/richardnguyen0715/keep-it-real --skill speckit-clarify-richardnguyen0715
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/richardnguyen0715/keep-it-real/tree/main/demo-projects/simple-agent/.github/skills/speckit-clarify
Command: npx skills add https://github.com/richardnguyen0715/keep-it-real --skill speckit-clarify-richardnguyen0715

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill identifies underspecified areas in feature specifications by asking up to 5 highly targeted clarification questions, reducing ambiguity and improving spec quality.

Core Features & Use Cases

  • Targeted Clarification: Asks up to 5 questions to resolve ambiguity in feature specs.
  • Spec Integration: Records clarifications directly in the spec file.
  • Compatibility: Requires spec-kit project structure with a .specify/ directory.
  • Use Case: Use this Skill to refine your feature spec by identifying and addressing areas of ambiguity before planning.

Quick Start

Run the speckit-clarify skill in your spec-kit project directory to start the clarification process.

Frequently Asked Questions about speckit-clarify

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I identify and resolve ambiguity in a feature specification?

To resolve ambiguity in a feature specification, you can use a clarification process that analyzes your spec and asks up to 5 targeted questions to address underspecified areas. This directly updates and refines the feature specification quality.

When do I need to refine a feature spec before planning?

You need to refine a feature spec before planning when the specification contains underspecified areas. Asking targeted clarification questions helps reduce ambiguity and ensures all requirements are clearly defined before moving into the planning phase.

Does spec-kit support automatic clarification for underspecified features?

Yes, spec-kit supports automatic clarification through targeted scripts that ask up to 5 questions to resolve ambiguity. It utilizes YAML parsing and Markdown file manipulation to record clarifications directly in the spec file.

How do I update a Markdown feature spec with clarification answers?

You can update a Markdown feature spec by running a clarification skill in your project directory. The skill manipulates the Markdown files and records your clarification answers directly within the existing feature specification document.

Do I need a specific project structure to clarify feature specifications?

Yes, you need a spec-kit project structure with a .specify/ directory to clarify feature specifications. The clarification process relies on this specific project layout to parse YAML and manipulate Markdown spec files correctly.

What is the limit of clarification questions asked for feature specification refinement?

The limit for feature specification refinement is up to 5 highly targeted clarification questions. This constraint ensures that only the most critical underspecified areas are addressed, reducing ambiguity without overwhelming the user.