speckit-clarify

Scan feature specifications against a taxonomy and resolve ambiguities interactively.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill addresses the common issue of vague or incomplete feature specifications by identifying missing decision points and forcing structured resolution before implementation begins.

Core Features & Use Cases

  • Ambiguity Detection: Scans specifications against a comprehensive taxonomy to flag missing functional, non-functional, and edge-case requirements.
  • Interactive Clarification: Guides the user through a prioritized, 5-question limit loop to resolve critical uncertainties.
  • Automated Integration: Automatically updates the specification file with the clarified answers to ensure the source of truth remains current.

Quick Start

Invoke the speckit-clarify skill to scan the current feature specification and resolve any identified ambiguities through an interactive session.

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 software feature specification?

To identify ambiguities in a feature specification, scan the document against a structured taxonomy to flag missing functional, non-functional, and edge-case requirements. This structured process ensures all decision points are captured and testable.

What is the best way to clarify missing requirements in a specification document?

The best way to clarify missing requirements is through an interactive questioning loop that guides you through a prioritized list of critical uncertainties. This approach limits the session to five questions to resolve ambiguities efficiently without overwhelming the user.

Do I need a specific project structure to run specification clarification?

Yes, specification clarification requires a project structure containing a .specify directory and a valid feature specification file. This setup allows the scanning process to locate and analyze the target document for missing decision points.

How does ambiguity resolution update the original specification file?

Ambiguity resolution updates the specification file through automated integration, immediately writing the clarified answers back into the source document. This ensures the specification remains the current source of truth for downstream planning and development.

When should I scan a feature specification for edge-case requirements?

You should scan a feature specification for edge-case requirements during the planning phase, before implementation begins. Resolving these critical uncertainties early ensures the requirements are testable, complete, and ready for software development workflows.