speckit-clarify

Detect ambiguities in feature specifications and generate targeted clarification questions.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill addresses underspecified requirements by systematically identifying and resolving ambiguities before development begins, reducing rework and ensuring clarity.

Core Features & Use Cases

  • Ambiguity Detection: Scans specifications against a comprehensive taxonomy to find missing or unclear details.
  • Targeted Questioning: Generates prioritized, concise questions to elicit necessary information.
  • Incremental Spec Update: Integrates answers directly back into the specification document.
  • Use Case: Before planning a new feature, run this Skill to ensure all functional scope, non-functional requirements, and edge cases are clearly defined, preventing costly misunderstandings later.

Quick Start

Use the speckit clarify skill to resolve ambiguities in the current feature specification.

Frequently Asked Questions about speckit-clarify

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

FAQPage Schema
How do I resolve ambiguities in underspecified software requirements?

To resolve ambiguities in underspecified requirements, you can use a structured clarification workflow that scans specifications against a taxonomy to find missing details and generates targeted questions to elicit necessary information.

What is the best way to detect missing functional scope and edge cases before development?

Detecting missing functional scope and edge cases is best achieved by scanning feature specifications against a comprehensive taxonomy to identify unclear details before planning begins, reducing costly rework.

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

Yes, running a specification clarification workflow requires a .specify/ project structure. This setup allows the tool to integrate answers directly back into your spec file during the clarification process.

How do I generate targeted questions for non-functional requirements in a spec file?

Generating targeted questions for non-functional requirements involves detecting ambiguities within the specification document and producing prioritized, concise questions to ensure all attributes are clearly defined.

Can I update a feature specification incrementally as clarification answers are provided?

Yes, you can update a feature specification incrementally. The clarification workflow integrates answers directly back into the specification document as targeted questions are resolved.

When should I not use an automated ambiguity detection workflow for requirements?

You should avoid automated ambiguity detection if your project lacks the required .specify/ directory structure, as the workflow relies on this specific environment to scan and update specification files.