speckit-clarify

Identify underspecified areas in feature specs and generate clarifying questions.

1|Updated Mar 26, 2026

Search Tags:#automation #workflow #requirements #spec #speckit #clarify

Ready to run

npx skills add https://github.com/apply-the/canon --skill speckit-clarify-apply-the

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/apply-the/canon/tree/main/.agents/skills/speckit-clarify
Command: npx skills add https://github.com/apply-the/canon --skill speckit-clarify-apply-the

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identify underspecified areas in the current feature specification by prompting concise, high-impact clarifications and encoding answers back into the spec.

Core Features & Use Cases

Guided clarification workflow that asks up to 5 targeted questions.
Automatically encodes answers into the .specify/ spec file to keep docs synchronized.
Enables early risk reduction by surfacing ambiguities before planning or execution.

Quick Start

Run the clarifications workflow against the active feature spec and answer prompts to finalize clarifications.

Frequently Asked Questions about speckit-clarify

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

FAQPage Schema

How do I clarify underspecified areas in a feature spec before planning?▼

Spec clarification involves identifying ambiguities in feature requirements and generating up to 5 targeted questions. This workflow surfaces underspecified areas before planning, reducing early project risk by encoding accepted answers directly back into the feature spec.

Does spec clarification require a specific directory structure to work?▼

Yes, spec clarification requires an existing .specify/ directory structure. The workflow operates exclusively on feature specs managed within this .specify/ workflow, automatically encoding accepted answers into the spec file with timestamped session entries.

How does the clarification workflow update feature requirements with answers?▼

The workflow updates feature requirements by appending a '## Clarifications' section to the spec file. Each accepted answer is encoded under a '### Session YYYY-MM-DD' entry, keeping documentation synchronized with the latest clarifications.

What is the maximum number of clarification questions generated for a feature spec?▼

The maximum number of clarification questions generated is 5. The workflow guides users through answering these targeted questions to finalize clarifications, ensuring the process remains concise and high-impact before proceeding to planning.

When should I run a clarification workflow on my feature spec?▼

Run the clarification workflow before proceeding to the planning phase. It identifies underspecified areas in your current feature spec, enabling early risk reduction by surfacing ambiguities and encoding the answers back into the .specify/ documentation.