speckit-clarify

Identify and resolve feature specification ambiguities through targeted clarification questions.

1|Updated Jun 16, 2025
One-click install
npx skills add https://github.com/imbatony/pavone --skill speckit-clarify-imbatony
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/imbatony/pavone/tree/main/.claude/skills/speckit-clarify
Command: npx skills add https://github.com/imbatony/pavone --skill speckit-clarify-imbatony

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It eliminates uncertainty in feature specifications by automatically generating up to five precise clarification questions and embedding the answers back into the spec file.

Core Features & Use Cases

  • Targeted Question Generation: Scans the spec, identifies vague or missing sections, and proposes up to five high‑impact clarification prompts.
  • Interactive Workflow: Guides the user through a concise Q&A session, ensuring each answer is captured and reflected in the document.
  • Automated Spec Updating: Inserts clarified information directly into the appropriate sections of the FEATURE_SPEC, maintaining markdown structure.
  • Use Case: When a product manager drafts a new feature spec and discovers ambiguous requirements, invoking this skill streamlines clarification before planning or implementation.

Quick Start

Run the speckit‑clarify skill on the repository root to start the clarification session.

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 requirements in a feature specification?

To clarify ambiguous requirements in a feature specification, you can use an automated workflow that scans the document, identifies vague sections, and generates up to five targeted questions to resolve uncertainties directly within the spec file.

What is the best way to update a FEATURE_SPEC file with clarification answers?

The best way to update a FEATURE_SPEC file is through an interactive workflow that captures your answers during a Q&A session and embeds the clarified information directly into the appropriate sections while maintaining the markdown structure.

How many clarification questions does this spec clarification workflow generate?

The spec clarification workflow generates up to five high-impact clarification questions designed to target and resolve ambiguities in the feature specification without overwhelming the stakeholder.

Do I need a .specify directory to run the spec clarification process?

Yes, you need a spec-kit project containing a .specify directory and a FEATURE_SPEC file to run the clarification process, as it requires executing repository scripts for prerequisite checks and in-place spec modification.

When should I automate spec clarification questions during product planning?

You should automate spec clarification questions during product planning right after a product manager drafts a new feature spec and discovers ambiguous requirements, streamlining the clarification process before development begins.