speckit-clarify

Identify underspecified areas in feature specifications and generate clarifying questions.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identify underspecified areas in a feature specification and generate targeted clarifications that are encoded back into the spec.

Core Features & Use Cases

  • Structured ambiguity detection across functional requirements, data models, and UX flows.
  • Interactive questioning loop that records accepted answers under a "Clarifications" section and can be reviewed later.
  • Automatic updates to the spec to reflect decisions, ensuring traceability and alignment with planning.

Quick Start

Run the speckit-clarify workflow against your spec to generate up to five clarifying questions and apply accepted answers into the document.

Frequently Asked Questions about speckit-clarify

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

FAQPage Schema
How do I identify ambiguities in a feature specification?

To identify ambiguities in a feature specification, use a structured clarification workflow that detects underspecified areas across functional requirements, data models, and UX flows. It generates targeted questions to resolve gaps and records answers directly into the spec.

What is the best way to add clarifications to a spec while keeping it traceable?

The best way to add clarifications to a spec while keeping it traceable is to record accepted answers under a dedicated Clarifications section. This ensures decisions are documented, testable, and aligned with planning within the specification workflow.

How do I generate targeted questions for underspecified functional requirements?

You can generate targeted questions for underspecified functional requirements by running a two-stage clarification process against your specification. This interactive questioning loop produces up to five questions to collect missing details and apply them back into the document.

Does the spec clarification process support interactive questioning and automatic updates?

Yes, the spec clarification process supports an interactive questioning loop that collects answers and applies them automatically. It updates the specification document to reflect decisions, ensuring changes are traceable and testable within the workflow.

Can I review specification clarifications after they are recorded into the document?

Yes, you can review specification clarifications after they are recorded into the document. Accepted answers are stored under a specific Clarifications section, allowing you to review decisions later and maintain alignment with planning.