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.