speckit-clarify

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

Updated Aug 28, 2026
One-click install
npx skills add https://github.com/KarenTenorio963/curso-mcp-karentenorio --skill speckit-clarify-karentenorio963
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/KarenTenorio963/curso-mcp-karentenorio/tree/main/entregas/s4/mi-proyecto-speckit/.agents/skills/speckit-clarify
Command: npx skills add https://github.com/KarenTenorio963/curso-mcp-karentenorio --skill speckit-clarify-karentenorio963

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Feature specifications often contain ambiguities, missing decisions, and vague requirements that cause rework during planning and implementation. This Skill systematically scans a spec-kit feature specification, asks up to five targeted clarification questions, and writes the accepted answers directly back into the spec. ## Core Features & Use Cases - Structured Ambiguity Scan: Evaluates the spec across 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 five questions per session. - Incremental Spec Integration: Appends each accepted answer to a Clarifications 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 agent to run the speckit-clarify skill to review the current feature specification and resolve its 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 the speckit-clarify skill from the repo root. It loads the current feature spec via check-prerequisites.ps1, scans it against an ambiguity taxonomy, asks up to five targeted questions, and writes accepted answers back into the spec file.

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 specification content.

How many clarification questions does speckit-clarify ask?▼

It asks a maximum of five questions per session, prioritized by impact and uncertainty. Each question is either multiple-choice with a recommended option or a short answer constrained to five words or fewer.

Does speckit-clarify require a specific project structure?▼

Yes, it requires a spec-kit project with a .specify directory containing scripts and memory. If the feature spec is missing, it instructs you to run /speckit-specify first rather than creating a new spec.

What happens to the requirements checklist after clarification?▼

If FEATURE_DIR/checklists/requirements.md exists, the skill re-evaluates each checkbox item against the updated spec, toggling only markers whose pass/fail state changed, and reports before/after pass counts in the completion report.