speckit.clarify

Identify underspecified areas in feature specs through structured clarification questions.

2|Updated Apr 11, 2026
One-click install
npx skills add https://github.com/JaimeJunr/context-mode --skill speckit-clarify-jaimejunr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit.clarify
Source: https://github.com/JaimeJunr/context-mode/tree/main/.claude/skills/speckit/speckit.clarify
Command: npx skills add https://github.com/JaimeJunr/context-mode --skill speckit-clarify-jaimejunr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

## What problem does it solve? Clarifies underspecified areas in a feature spec by orchestrating up to 5 targeted questions and writing answers back into the spec to reduce ambiguity and rework.

## Core Features & Use Cases

  • Structured ambiguity scans across functional scope, data model, UX flows, and non-functional attributes.
  • Interactive, one-question-at-a-time clarification loop that guides decision making and minimizes downstream rework.
  • Automatic update of a Clarifications section in the spec, with session-level tracking for traceability.

### Quick Start Run the interactive clarification loop to surface gaps in the current feature spec and update it with concise answers.

Frequently Asked Questions about speckit.clarify

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

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

Ambiguities in a feature specification are identified through structured scans across functional scope, data models, and UX flows. This process surfaces underspecified areas using targeted clarifications to minimize downstream rework.

What is the best way to resolve spec gaps during requirements drafting?

Resolving spec gaps during requirements drafting is best handled by an interactive, one-question-at-a-time clarification loop. This guides decision-making and writes concise answers directly back into the spec for traceability.

How does a structured clarification loop improve spec traceability?

A structured clarification loop improves spec traceability by automatically updating a dedicated Clarifications section within the spec. It tracks session-level answers and links them directly to the relevant spec sections.

Can I review non-functional requirements and compliance considerations in a spec clarification workflow?

Yes, you can review non-functional attributes and compliance considerations within a spec clarification workflow. The ambiguity scan explicitly targets these areas alongside functional scope and data models to ensure completeness.

When do I need to run a spec clarification process?

You need to run a spec clarification process during spec drafting and review phases. It is required when you must surface ambiguities across functional scope, data models, UX flows, and compliance considerations to drive concrete clarifications.

What are the limitations of automated spec gap detection?

Automated spec gap detection limits ambiguity resolution to up to 5 targeted questions per session. It requires structured questionnaire steps and existing spec sections to trace clarifications, meaning entirely unstructured documents lack sufficient context.