speckit-clarify

Detects ambiguities in feature specifications and records targeted clarification answers into the spec file.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Feature specifications often contain vague requirements, missing decisions, and unresolved placeholders that cause rework during planning and implementation. This Skill systematically scans a spec for underspecified areas and resolves them through focused questions before planning begins. ## Core Features & Use Cases - Structured Ambiguity Scan: Evaluates the spec across a taxonomy covering functional scope, data model, UX flows, non-functional requirements, integrations, edge cases, and terminology. - Interactive Questioning Loop: Asks up to 5 high-impact questions one at a time, each with a recommended option or suggested answer, and encodes accepted answers directly into the spec under a Clarifications section. - Checklist Re-validation: Re-evaluates the spec quality checklist after updates, reporting newly passing items, regressions, and remaining gaps. - Use Case: Before running speckit-plan on a new feature, run this Skill to resolve open questions about security posture, data constraints, or acceptance criteria so downstream tasks are built on confirmed decisions. ## Quick Start Ask the assistant to run the speckit-clarify skill to review the current feature spec and resolve its ambiguities.

Frequently Asked Questions about speckit-clarify

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

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

Run the clarify workflow on the active feature spec. It scans the spec across categories like functional scope, data model, and edge cases, then asks up to five targeted questions and writes the accepted answers into a Clarifications section.

When should I run spec clarification in spec-kit?

Run clarification after creating the spec with speckit-specify and before running speckit-plan. Skipping it is allowed for exploratory spikes, but downstream rework risk increases because planning will rely on unresolved assumptions.

What project structure does speckit-clarify require?

It requires a spec-kit project with a .specify directory and an active feature spec located via the check-prerequisites script. If the spec file is missing, you must run speckit-specify first.

How many clarification questions can be asked per session?

A maximum of five questions per session. Each question must be answerable with a multiple-choice selection or a short answer of five words or fewer, and retries for the same question do not count against the quota.

Does clarification update the spec quality checklist automatically?

Yes. If a requirements checklist exists in the feature directory, it re-evaluates each checkbox against the updated spec, toggles only markers whose state changed, and reports newly passing items, regressions, and remaining gaps.