m-sdd-clarify

Clarify software specification ambiguities through user interviews and document edits.

2|Updated Jul 2, 2026
One-click install
npx skills add https://github.com/mituso89/Spec-Driven-Development-toolkits --skill m-sdd-clarify
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: m-sdd-clarify
Source: https://github.com/mituso89/Spec-Driven-Development-toolkits/tree/main/m-sdd-clarify
Command: npx skills add https://github.com/mituso89/Spec-Driven-Development-toolkits --skill m-sdd-clarify

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps resolve ambiguities in a spec by conducting interviews with the user, ensuring that all aspects of the spec are clear and well-defined.

Core Features & Use Cases

  • User Interview: Conducts a self-contained ambiguity interview with the user to clarify spec ambiguities.
  • Spec Enhancement: Appends the clarifications to the spec document, improving its clarity and completeness.
  • Use Case: When a spec document has ambiguities that need to be resolved before proceeding to the next phase of development.

Quick Start

Run the 'm-sdd-clarify' skill to resolve ambiguities in the current spec.

Frequently Asked Questions about m-sdd-clarify

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

FAQPage Schema
How do I resolve ambiguities in a software specification document?

To resolve ambiguities in a software specification, you can conduct a structured user interview to identify unclear requirements and append clarifications directly to the spec document, ensuring all aspects are well-defined before development proceeds.

When do I need to clarify spec ambiguities in the SDD pipeline?

Spec ambiguity clarification is needed before proceeding to the next phase of development when a specification document contains unclear requirements that must be resolved and documented to ensure accurate implementation.

What is the best way to conduct a user interview for spec clarity?

The best way to conduct a user interview for spec clarity is to run a self-contained ambiguity interview that systematically questions the user about unclear aspects and appends their clarifications to the specification document.

Does clarifying a specification require manual user interaction?

Yes, clarifying a specification requires manual user interaction to answer interview questions about ambiguous requirements, along with spec document editing to append the resulting clarifications for enhanced completeness.

How do I improve the clarity and completeness of an existing spec?

You can improve spec clarity and completeness by facilitating a user interview to resolve ambiguities, then appending the documented clarifications directly to the existing specification document to enhance its overall quality.

Can I automate ambiguity resolution for software specifications?

Ambiguity resolution for software specifications cannot be fully automated because it requires interactive user interviews to clarify unclear requirements, ensuring that all aspects of the spec are clearly understood and documented.