speckit-clarify

Generate targeted clarification questions for feature specifications and encode answers into the spec.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/tellbom/process --skill speckit-clarify-tellbom
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/tellbom/process/tree/main/.agents/skills/speckit-clarify
Command: npx skills add https://github.com/tellbom/process --skill speckit-clarify-tellbom

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

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

Core Features & Use Cases

  • Surface ambiguities in feature specifications and generate targeted clarifying questions (up to five).
  • Integrate accepted answers into the spec under a structured Clarifications section with session tracking.
  • Respect extension hooks and ensure safe, auditable modifications to the spec as part of the clarification workflow.

Quick Start

Run speckit-clarify against your feature spec to surface ambiguities and encode answers back into the spec.

Frequently Asked Questions about speckit-clarify

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

FAQPage Schema
How do I clarify ambiguous requirements in a feature specification?

Feature specification clarification works by generating up to five targeted questions to surface underspecified areas, then encoding accepted answers back into the spec. This ensures ambiguities are resolved through structured, testable modifications rather than informal discussions.

Can I update a spec-kit specification with session-based tracking?

Yes, you can update a spec-kit specification using session-based tracking. The skill manages a dedicated Clarifications area and integrates accepted answers under a structured section, ensuring safe and auditable modifications to the feature spec.

Does spec clarification work with extension hooks in a .specify directory?

Yes, spec clarification works directly with projects using a spec-kit structure containing a .specify directory and extension hooks. The process respects these hooks to ensure safe, auditable modifications during the interactive clarification workflow.

What is the best way to resolve underspecified areas in software requirements?

The best way to resolve underspecified areas in software requirements is by generating highly targeted clarification questions. This approach limits scope to five questions, applies answers as testable spec changes, and maintains auditable session tracking for documentation.

How many clarification questions can I generate for a feature spec?

You can generate up to five highly targeted clarification questions for a feature spec. This limit ensures the refinement process remains focused on resolving the most critical ambiguities and encoding them as concrete, testable modifications.