speckit-clarify

Identify underspecified areas in feature specifications and generate prioritized clarification questions.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/xyphyx/internal-project-template --skill speckit-clarify-xyphyx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/xyphyx/internal-project-template/tree/main/.claude/skills/speckit-clarify
Command: npx skills add https://github.com/xyphyx/internal-project-template --skill speckit-clarify-xyphyx

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identify underspecified areas in the current feature specification and generate concise, answerable clarifications.

Core Features & Use Cases

  • Structured ambiguity detection across functional requirements, data models, UX interactions, non-functional criteria, and edge cases.
  • Interactive, one-question-at-a-time clarification loop that yields up to five high-impact questions.
  • Automatic embedding of accepted answers into a dedicated Clarifications section in the spec, with traceable updates after each acceptance.

Quick Start

Describe or supply a current feature spec to initiate the clarifications flow.

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?

Feature specification ambiguity is identified by analyzing functional requirements, data models, UX interactions, non-functional criteria, and edge cases to generate concise, answerable clarifications for stakeholders.

What is the best way to clarify requirements with stakeholders for product management?

The best way to clarify requirements is using an interactive, one-question-at-a-time loop that surfaces up to five high-impact questions, ensuring stakeholders address critical specification gaps without being overwhelmed.

How do I track clarifications and accepted answers within a feature spec?

Accepted answers are automatically applied to the feature spec in a dedicated, traceable Clarifications section after each acceptance, maintaining a clear record of updated functional requirements and edge case decisions.

Can I use targeted questions to detect missing edge cases in my product spec?

Yes, targeted questions are generated specifically to detect missing edge cases, alongside gaps in non-functional criteria and UX interactions, prioritizing the most high-impact underspecified areas for stakeholders to resolve.

Do I need to supply a complete feature spec to start generating clarifications?

You do not need a complete feature spec; you simply describe or supply a current draft of the feature specification to initiate the interactive clarifications flow and begin surfacing targeted questions.