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.