speckit-clarify

Detect underspecified areas in feature specs and record answers back.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

## What problem does it solve? Identify underspecified areas in the current feature specification and generate targeted clarifications.

## Core Features & Use Cases

  • Structured ambiguity detection across multiple taxonomy areas (Functional, Data, UX, Non-functional, etc.)
  • Interactive, capped questioning loop (max 5 questions) with one-at-a-time prompts
  • Automatic spec augmentation under a dedicated Clarifications section with session history
  • Safe, audit-friendly updates ensuring traceability between questions and answers

### Quick Start Ask up to five targeted clarifying questions to resolve ambiguities in the feature spec and encode answers back into FEATURE_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 feature specifications before development?

To clarify ambiguous feature specifications, you can generate targeted questions that identify underspecified areas across functional, data, and UX categories. This process scopes inquiries to high-impact categories and encodes answers back into the spec.

What is the best way to resolve underspecified requirements in a spec?

Resolving underspecified requirements involves running an interactive questioning loop capped at five questions. This structured approach detects ambiguity across taxonomy areas and records answers under a dedicated Clarifications section for traceability.

How does a capped questioning loop work for requirement clarification?

A capped questioning loop works by prompting up to five targeted clarifying questions one at a time. It detects ambiguity across multiple taxonomy areas and automatically augments the feature specification with audit-friendly answers.

Can I automatically update my feature spec with clarification answers?

Yes, you can automatically update your feature spec with clarification answers. The system records session history and applies safe, audit-friendly updates to ensure traceability between the questions and answers.

What are the limitations of automated specification clarification?

The main limitation of automated specification clarification is the strict five-question limit per session. This cap scopes questions to the most impactful categories but may require multiple sessions to fully resolve extensive ambiguities in complex workflows.

Does spec clarification work alongside existing quality assurance workflows?

Yes, spec clarification works alongside existing quality assurance workflows through programmable integration. It enforces structured response formats and records targeted clarifications, reducing rework and ensuring traceability within your spec workflow.