speckit-clarify

Scan .specify feature specs and ask up to five targeted clarification questions.

1|Updated May 20, 2026
One-click install
npx skills add https://github.com/sabrydawood/claude-config --skill speckit-clarify-sabrydawood
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/sabrydawood/claude-config/tree/main/skills/speckit-clarify
Command: npx skills add https://github.com/sabrydawood/claude-config --skill speckit-clarify-sabrydawood

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires .specify/scripts/powershell/check-prerequisites.ps1, and includes scripts (resource) components.

What problem does it solve?

It identifies missing decisions and ambiguity in a feature specification and converts them into targeted clarifications that you can record back into the spec before planning.

Core Features & Use Cases

  • Clarification-driven spec refinement: Scans the spec for partial or missing information across scope, data model, UX, and non-functional requirements.
  • Up to 5 targeted questions: Asks only high-impact questions that materially affect architecture, task decomposition, tests, UX behavior, operational readiness, or compliance validation.
  • Spec-integrated answers: Records each accepted answer directly into the appropriate spec sections, adding measurable criteria and edge-case handling where needed.

Quick Start

Run the speckit-clarify flow on your current feature spec to receive one high-impact clarification question at a time, then answer it to update the spec.

Frequently Asked Questions about speckit-clarify

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

FAQPage Schema
How do I identify missing requirements in a feature specification before planning?

To identify missing requirements in a feature specification, you scan the spec for ambiguity across scope, data modeling, UX flows, and non-functional requirements to surface targeted clarification questions before planning begins.

What is the best way to clarify vague feature specifications and reduce downstream rework?

The best way to clarify vague feature specifications is interactively asking up to five high-impact questions that materially affect architecture and UX, then recording the accepted answers directly into the spec sections to reduce downstream rework.

How do I update a feature spec with acceptance criteria and edge-case handling?

You update a feature spec by interactively answering targeted clarification questions, which automatically writes the clarifications, acceptance criteria, and edge-case handling back into the appropriate sections of the active specification file.

Does the spec clarification process ask an unlimited number of questions?

No, the spec clarification process enforces a strict cap of up to five targeted questions to ensure only high-impact decisions affecting architecture, task decomposition, tests, and operational readiness are addressed.

Can I use this feature spec clarification workflow without PowerShell prerequisites?

No, you cannot use this workflow without PowerShell prerequisites because the clarification process requires executing the check-prerequisites.ps1 script within the .specify environment to validate the active feature spec setup.