skills.rest
tomlm
tomlmCOMMUNITY
Explore all skills by this author →
GitHub

speckit-clarify

Generate targeted clarification questions for underspecified feature specifications and record answers.

Updated Feb 26, 2026
Search Tags:#planning#documentation#requirements#specifications#ambiguity#clarify
One-click install
npx skills add https://github.com/tomlm/Boxcars --skill speckit-clarify-tomlm
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/tomlm/Boxcars/tree/main/.agents/skills/speckit-clarify
Command: npx skills add https://github.com/tomlm/Boxcars --skill speckit-clarify-tomlm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identify underspecified areas in active feature specifications by generating up to 5 highly targeted clarification questions and encoding answers back into the spec.

Core Features & Use Cases

  • Detect and prioritize ambiguities across functional requirements, data models, UX flows, non-functional criteria.
  • Incrementally update the spec with clarifications under a dedicated Clarifications session.
  • Support planning and reduce downstream rework by surfacing decision points early.

Quick Start

Load the current spec and start a clarifications loop to surface and resolve high-impact 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 feature specifications before development?▼

Detect ambiguities in feature specifications by analyzing functional requirements, data models, UX flows, and non-functional criteria. This process surfaces underspecified areas early, reducing downstream rework by resolving decision points before development begins.

How do I resolve underspecified requirements in a software spec?▼

Resolve underspecified requirements by running a structured clarifications loop that generates targeted questions. Answers are incrementally updated and validated directly back into the active feature specification under a dedicated Clarifications session.

Do I need a specific directory structure to use automated spec clarification?▼

Yes, automated spec clarification requires a project with a .specify/ directory. The workflow uses JSON-prerequisite checks to validate the environment before generating targeted questions and incrementally updating the specification.

Can I prioritize clarification questions for large feature scopes?▼

Yes, the tool scales to varying feature scopes by prioritizing question selection. It applies a structured ambiguity taxonomy to ensure high-impact decision points are surfaced first across functional requirements and non-functional criteria.

What's the best way to trace specification decisions during planning?▼

Trace specification decisions by encoding clarification answers directly into the spec under a dedicated session. This creates a traceable record of resolved ambiguities, supporting planning and reducing downstream rework.

Related Skills

Explore More Product & Management Skills→
dmae97dmae97
130

speckit-clarify

Ask up to five targeted questions and write answers into feature specs.

Community
Intermediate
forztfforztf
9

speckit-clarify-zh

Generate up to five clarifying questions and encode answers into feature specifications.

Community
Advanced
richfremrichfrem
5

spec-kitty-clarify

Identify underspecified areas in feature specifications and propose targeted clarifications.

Community
Advanced
GenerativeAgentsGenerativeAgents

glossary-creation

Extract and consolidate project terms into a standardized glossary at docs/glossary.md.

Official
Advanced