speckit-clarify

Detect underspecified areas in feature specs and encode answers back into the file.

Updated Mar 3, 2026
One-click install
npx skills add https://github.com/arielybarak/agent-lab --skill speckit-clarify-arielybarak
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/arielybarak/agent-lab/tree/main/.claude/skills/speckit-clarify
Command: npx skills add https://github.com/arielybarak/agent-lab --skill speckit-clarify-arielybarak

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the challenge of underspecified areas in a feature specification by prompting up to 5 targeted clarification questions, encoding answers back into the spec.

Core Features & Use Cases

  • Targeted Clarification: Asks up to 5 questions to identify underspecified areas in the feature spec.
  • Spec Integration: Encodes answers back into the spec file to enhance clarity and accuracy.
  • Compatibility: Requires a spec-kit project structure with a .specify/ directory.

Quick Start

Use the speckit-clarify skill on your spec to get targeted clarifications and enhance its comprehensiveness.

Frequently Asked Questions about speckit-clarify

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

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

To clarify ambiguities in a feature specification, use tools that detect underspecified areas and prompt targeted questions. This skill asks up to 5 questions and encodes answers directly back into the spec file.

Do I need a specific project structure to use spec clarification tools?

Yes, spec clarification requires a Spec-Driven Development environment with a .specify/ directory containing an extensions.yml file. This spec-kit project structure is required to detect ambiguities and encode answers back into the spec.

How many clarification questions will I be prompted to answer for my spec?

You will be prompted with up to 5 targeted clarification questions to identify underspecified areas in your feature specification. This limit ensures the clarification process remains focused and manageable.

What is the best way to encode clarification answers back into a feature spec?

The best way to encode answers is by using an AI-assisted engineering workflow that automatically integrates your responses directly into the spec file. This enhances feature specification clarity and accuracy without manual updates.

When should I use AI-assisted clarification for feature development?

Use AI-assisted clarification during feature development when your specification has underspecified areas. It is ideal for Spec-Driven Development environments to resolve ambiguities before implementation begins.