speckit-clarify

Generate targeted clarification questions and update feature specifications with answers.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

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

Core Features & Use Cases

  • Generate up to five targeted clarification questions to resolve ambiguities in a feature specification.
  • Update the specification by embedding accepted answers under a Clarifications section, preserving structure and traceability.
  • Support an interactive questioning loop with a one-question-at-a-time cadence and atomic updates to the spec.

Quick Start

Ask up to five targeted clarification questions and apply the 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 identify ambiguities in a feature specification before development?

To identify ambiguities in a feature specification, you can generate up to five targeted clarification questions that pinpoint underspecified areas in the spec. This process highlights gaps and resolves ambiguities before planning begins.

What is the best way to update a spec with clarification answers interactively?

The best way to update a spec with clarification answers is through an interactive loop that embeds validated answers under a dedicated Clarifications section. This preserves the specification structure and ensures traceability of updates.

Can I resolve requirements gaps by asking one clarification question at a time?

Yes, you can resolve requirements gaps by enforcing a one-question-at-a-time cadence. This minimal interaction approach guides you through a structured clarification loop and applies atomic updates to the specification.

Does specification clarification work without external dependencies or components?

Specification clarification works independently without external dependencies or components. It safely enforces minimal interaction to identify underspecified areas and prepares the feature specification for subsequent validation tasks.

When should I not use automated clarification questions for spec updates?

You should not use automated clarification questions if your specification requires updating more than five targeted areas at once. The workflow is designed for minimal, safe interaction and limits generation to five targeted questions per loop.