speckit-clarify

Identifies underspecified areas in feature specs and records targeted clarification answers.

9|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/timcsy/semorphe --skill speckit-clarify-timcsy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/timcsy/semorphe/tree/main/.claude/skills/speckit-clarify
Command: npx skills add https://github.com/timcsy/semorphe --skill speckit-clarify-timcsy

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 detects those gaps 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. - Prioritized Questioning: Asks up to 5 high-impact questions one at a time, each with a recommended answer and multiple-choice or short-answer format. - Incremental Spec Updates: Writes each accepted answer back into the spec under a Clarifications section and updates the relevant requirement sections, then re-validates the spec quality checklist. - Use Case: After drafting a feature spec with /speckit-specify, run this Skill to resolve open questions like authentication strategy or data retention limits before invoking /speckit-plan. ## Quick Start Ask the assistant to run the speckit-clarify skill to review the current feature spec and clarify any underspecified areas.

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 after creating a spec with /speckit-specify. It scans the spec across categories like functional scope, data model, and edge cases, then asks up to 5 targeted questions and writes the answers directly into the spec file.

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

Run clarification after /speckit-specify and before /speckit-plan. Skipping it is allowed for exploratory spikes, but the skill warns that downstream rework risk increases when ambiguities remain unresolved.

What project structure does speckit-clarify require?▼

It requires a spec-kit project with a .specify directory containing scripts and the feature spec. It runs check-prerequisites.sh to locate FEATURE_DIR and FEATURE_SPEC, and aborts if the spec file is missing.

How many clarification questions does the skill ask?▼

It asks a maximum of 5 questions per session, presented one at a time. 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 spec quality checklist?▼

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