speckit-clarify

Detects underspecified areas in feature specs and integrates targeted clarification answers into the spec file.

Updated Jul 20, 2026
One-click install
npx skills add https://github.com/guihocosta/getsemani-app --skill speckit-clarify-guihocosta
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/guihocosta/getsemani-app/tree/main/.claude/skills/speckit-clarify
Command: npx skills add https://github.com/guihocosta/getsemani-app --skill speckit-clarify-guihocosta

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Feature specifications often contain ambiguities, missing decision points, and vague requirements that cause downstream rework during planning and implementation. This Skill systematically scans a spec-kit feature spec, asks up to 5 targeted clarification questions, and writes the answers directly back into the spec. ## Core Features & Use Cases - Structured Ambiguity Scan: Evaluates the spec against a taxonomy covering functional scope, data model, UX flows, non-functional attributes, integrations, edge cases, constraints, and terminology. - Interactive Questioning Loop: Presents one question at a time with recommended multiple-choice options or suggested short answers, capped at 5 questions per session. - Incremental Spec Integration: Appends each accepted answer to a Clarifications session section and updates the relevant spec sections, then re-validates the requirements checklist. - Use Case: Before running /speckit-plan on a new feature, run this Skill to resolve open questions about security posture, scale assumptions, and acceptance criteria so the plan is built on unambiguous requirements. ## Quick Start Ask the assistant to run /speckit-clarify on the current feature spec to identify and resolve ambiguities before planning.

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 spec-kit feature specification?▼

Run /speckit-clarify in a spec-kit project. It scans the active feature spec across categories like functional scope, data model, and non-functional requirements, then asks up to 5 targeted questions and writes the answers into a Clarifications section of the spec.

When should I run speckit-clarify in the spec-kit workflow?▼

Run it after /speckit-specify and before /speckit-plan. Clarifying first reduces downstream rework risk, since the plan and tasks are generated from the spec. Skipping it is allowed for exploratory spikes but increases misalignment risk.

Does speckit-clarify work without a .specify directory?▼

No. It requires the spec-kit project structure with a .specify directory and runs check-prerequisites.ps1 to locate the feature spec. If the spec file is missing, it instructs you to run /speckit-specify first.

How many clarification questions can speckit-clarify ask?▼

It asks a maximum of 5 questions per session, selected by an impact-times-uncertainty heuristic. Each question is either multiple-choice with a recommended option or a short answer constrained to 5 words or fewer.

Does speckit-clarify update the requirements checklist automatically?▼

Yes. If FEATURE_DIR/checklists/requirements.md exists, it re-evaluates each checkbox item against the updated spec, toggles only markers whose pass/fail state changed, and reports newly passing items, regressions, and remaining gaps.