spec-kit-clarify

Resolve high-impact ambiguities in a feature specification and update spec.md.

5|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/ahgraber/skills --skill spec-kit-clarify
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-kit-clarify
Source: https://github.com/ahgraber/skills/tree/main/skills/spec-kit-clarify
Command: npx skills add https://github.com/ahgraber/skills --skill spec-kit-clarify

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

Resolve high-impact ambiguities in an active feature specification before planning.

Core Features & Use Cases

  • Structured ambiguity assessment and tracking using the Spec Kit workflow.
  • Interactive clarification loop that surfaces critical questions and integrates answers into spec.md.
  • Ensures traceability of decisions with inline updates to the specification document.

Quick Start

Initiate the clarify workflow to resolve ambiguities in spec.md before planning.

Frequently Asked Questions about spec-kit-clarify

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

FAQPage Schema
How do I resolve ambiguous specifications before feature planning?

To resolve ambiguous specifications before planning, you can run a clarification workflow that identifies placeholders like NEEDS CLARIFICATION and updates spec.md with accepted answers to critical questions.

What is specification clarification and how does it handle unresolved scope decisions?

Specification clarification is a workflow that surfaces up to five high-impact questions to resolve unresolved scope decisions, ensuring unquantified requirements do not negatively affect architecture or data models.

How do I update spec.md with accepted answers from a clarification loop?

You update spec.md with accepted answers by initiating an interactive clarification loop that integrates decisions directly into the document, implementing structured ambiguity tracking and traceability.

Can I use a structured workflow to assess specification ambiguity for unquantified requirements?

Yes, you can use a structured workflow to assess specification ambiguity by evaluating unquantified requirements that affect validation, data models, or architecture, and tracking them for resolution.

What are the limitations of resolving high-impact ambiguities in feature specifications?

A limitation of resolving ambiguities in feature specifications is that the workflow surfaces a maximum of five critical questions, prioritizing only unresolved scope decisions that could impact architecture or validation.